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years young. Over the next twelve X possible! Above all, we're proud to 
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Stay young with us! 


The time has come: Elektor is 60 years old. In April 1961, Bob van der Horst published the first 
issue of his new magazine Elektronika Wereld (World of Electronics), which was later renamed 
Elektuur and then Elektor. The publisher sensed a gap in the market. Most of the electronics 
knowledge ofthe time was hidden in academic literature, countless datasheets, difficult-to-di- 
gest papers, and dull diagrams. Van der Horst foresaw that a lot of people like him would get 
excited about building electronic circuits and creatively adapting them for their own purposes 
or even developing them from scratch. To do this, you need the necessary knowledge, and the 
best way to impart that knowledge is to help your readers achieve a sense of achievement step 
by step. Learning happens along the way. 


Sixty years later, we remain true to this successful model. Multi-core programming, develop- 
ing with MicroPython, and connecting your own hardware to web platforms are just three of 
the topics we want to introduce to our readers step by step — with the proven mix of theory 
and practice. As Editor in Chief, I benefit from the fact that our editors and our authors are all 
infected by the DIY virus. As a result, I almost never get an article that is too dry and theoret- 
ical. Most ofthe time, I even have to slow down our creative minds so that the project doesn't 
become too extensive (after all, you always want a new issue on the table on time). The content 
we receive keeps our fingers on the pulse, and it keeps our team and our magazine fresh. I 
don't know what Elektor will be covering in a few decades; but for sure, our successors in 
the editorial meetings will be thinking about which projects will effectively demonstrate the 
exciting technologies! 


ELEKTOR @ 60: MORE TO COME! 


Elektor will celebrate 60 years of publishing and electronics innovation 
with a few exciting special projects. We are working on an anniversary 
book, a movie, a live event (World Ethical Electronics Forum), and the 
"Elektor mobile home lab." We bet you are curious. Stay tuned for 
more info inthe coming weeks. Have ideas for other special projects? 
send me your thoughts: denise.bodrone@elektor.com! 





Denise Bodrone 
Elektor 60 Committee Coordinator 
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LABS PROJECT 


DIY 





LiPo Supercharger Kit 


From Handcrafted to Mass Market 


By Mathias ClaufSen (Elektor) 


GreatScott! — a DIY electronics-focused YouTube channel with more than 1.4 million 
subscribers — and Elektor present a DIY rechargeable LiPo power supply. The handy 

kit offers users an entry into the world of SMD soldering, with carefully chosen 1206 
components and a partially assembled PCB. We experienced a few challenges while 
developing the kit, so we want to share with you the lessons we learned during the product 


development process. 
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SPECIFICATIONS 


> Input: 5 V +/-10% 
> Output:5V/15A0r12V/0.75A 
> Single Cell Lithium battery 


GreatScott! and Elektor met at the productro- 
nica 2019 trade show to discuss a new project 
— a DIY power source with a rechargeable 
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lithium battery. Most of us use a trusty bench- 
top power supply for our projects. But if you 
are working on designs that will eventually 
leave your workbench, like a self-driving scale 
car or an outdoor sensor, long leads are not 
really a solution. Such projects usually result 
in a bunch of batteries bundled together with 
gaffer tape and hot glued to an inexpensive 
DC/DC converter to form a mobile power 


1201" —À 


— 
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supply. To get a more robust system with 
added protection, GreatScott! and Elektor 
teamed up to develop a battery-powered 
rechargeable power supply that can use 
widely available lithium batteries. At the 
outset, the team knew it should be DIY and 
use SMD components to teach SMD soldering 
skills and to demonstrate that soldering SMD 
is not a kind of magic that only well-trained 






5 Volt / 12 Volt output 


Figure 1: Function blocks. 


wizards can do. During the meeting, we 
learned that GreatScott! had already prepa- 
red drafts for schematics and some calcula- 
tions. The difference between other supplies 
is the switchable output for 12 V or 5 V, which 
can be selected by the user. 


Function blocks 

To build a lithium battery charger and power 
supply, you must connect the functions blocks 
in the right way. Figure 1 shows the blocks 
involved in the design. 


The first block is the USB connector, so a 
Mains USB-adapter can be used to power 
the device. Here a PCB board is used that 
consists only of passive components, which 
breaks out all required signals on its edges. 
This one will be later placed on top of the 
main PCB and can be reused for other 
projects where USB-C may be used. Follo- 
wed by this is the lithium charging circuitry 
that takes the input voltage and will charge 
an attached battery. 


To avoid damage to the attached battery, 
we added protection (shown as its own 
block in Figure 1) to prevent over-current, 
over-charge, over-discharge and wrong 
polarity. In the center you can see the DC/DC 
converter that will provide 5 V or 12 V output. 
The final block after the DC/DC converter 
Is an eFuse that limits the provided output 
current to protect the DC/DC converter from 
damage. With these blocks attached in the 





Battery 
voltage 
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Figure 2: Schematic for the first revision. 


right way, you get a portable rechargeable 
power source. 


Off-the-shelf components 

The bill of material was optimized for China-ba- 
sed sourcing, which was something that in 
December 2019 seemed to be reasonably easy 
as goods to and from the Chinese mainland 
could be transferred in vast quantities for a 
low price. Most parts from the bill of materials 
could also be sourced from European suppliers. 
The important ICs for this project were from a 
well-known brand, Texas Instruments. Just one 
IC was only to be sourced at Chinese distribu- 
tors, but that does not seem like a problem. For 
charging a BQ24092DGQR from Texas Instru- 
ments is used that can deal with lithium ion 
and lithium polymer-based rechargeable batte- 
ries. To get the 12 V or 5 V output voltage, a 


GND ec cron 
Dp 191188-1 


TPS61085DGKR, also from Texas Instruments, 
is included and works as DC/DC boost conver- 
ter. Other parts like capacitors, resistors and 
inductors were all available from European 
distributors. Generally, the design used off-the- 
shelf components. An engineer at Elektor took 
over the schematic, bill of materials and first 
calculations. With this input, developing and 
routing a PCB was quickly done and the first 
prototype was ordered. It was ready for testing 
just before Christmas 2019. The schematic is 
shown in Figure 2 and the resulting PCB 
layout appears in Figure 3. The first test done 
by GreatScott! looked quite promising. The 
PCB could be produced, but that is not how 
the story ended. During that time, COVID-19 
began its journey around the world and was 
already starting to impact supply chains, with 
off-the-shelf components disappearing more 
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Figure 3: PCB layout for the first revision. 
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Figure 4: Schematic part of the charge circuit. 


and more from the shelves. In addition, two 
major glitches within the design showed up. 


Wrong power of 10 and 
disintegrating ICs 

A first test revealed that running of a recharge- 
able battery worked fine, but charging did not. 
Since a BQ24092DGQh Is installed, one has 
already seen this behavior in another product 
prototype. Figure 4 shows the schematic for 
battery charging. The resistor R10 is required 
to work these chips without a thermal resis- 
tor inside a battery pack. Depending on the 
BQ2409x type you choose, this can be 10 kO 
or 100 kO, and here it is 10 times higher than 
what the BQ24092DGQR expects. This leads 
to a noncharging battery as the charge IC is 
reading a temperature that is out of range. The 
fix is quite easy and requires only changing 
R10 to 10 kO instead of 100 kO. 


The second glitch was a bit more serious. 
During testing the DC/DC converter disin- 
tegrated if a high current was drawn. As 
the schematic in Figure 1 only has a battery 
protection IC that limits current form the 
battery at 10 A, this means approximately 
37 W that can go into the DC/DC boost 
stage. At 5 V output this would result in 74 A 
that could theoretically be drawn under ideal 
conditions. As we do not have ideal condi- 
tions, this means the DC/DC converter can 
get overloaded and its internal structure gets 
destroyed. Protection had to be installed for 
the DC/DC converter, but first some words 
on how a DC/DC converter works. 


How a DC/DC converter works 

The purpose of a DC/DC converter is to 
produce an output voltage that is lower or 
higher than the input voltage. If operating from 
AC voltages this is quite simple as a transfor- 
mer can be used and the output voltage will 
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Figure 5: Schematic part of the DC/DC converter. 


depend on the winding ratio. DC/DC conver- 
ters existed before the age of modern silicon 
devices. Mostly mechanical, they were tens of 
times bigger that what you can find in modern 
mobile electronics. A short description can be 
seen on the Wikipedia website [1]. 


The DC/DC converter used in modern electro- 
nics only require a few external parts to 
operate, as most of their circuitry is now integ- 
rated into a tiny device. If changing to a lower 
output voltage, this is called buck converter, 
one of the most common ones used. Changing 
from a lower to a higher voltage is done by 
a boost converter. The one used here is a 
TPS61085DGKR boost converter to generate 
5V or 12V from a 3V to 4.2V input. To describe 
how this is done, we first will have a look at 
Figure 5. From our input, we have an inductor 
L towards a diode D to the output. The inductor 
is also connected to a pin labeled SW, which is 
internally a switch that can connect the induc- 
tor to ground if required. To begin, we assume 
that the internal switch SW is in a closed state 
and current will flow through the inductor into 
the SW pin to ground. This will cause the induc- 
tor to generate a magnetic field. If the switch 
is now opened and the current through the 
inductor decreases, this will cause the induc- 
tor to keep the current towards the load and 
decrease the magnetic field. The decrease will 
reverse the polarity. We can see this swap on 
its left and right side, making the inductor act 
as series energy storage (like two AAA batte- 
ries you put in series to get a higher voltage). 


This voltage will add to the supply voltage and 
increase it. The resulting voltage will be the 
sum of both voltages. The supply voltage, and 
the voltage added by the inductor will pass the 
diode D. This voltage will charge the capacitor 
Cout. If the magnetic field is decreased to a 
point where the inductor is no longer adding 


to the output, the internal switch will be closed 
again. The reduced magnetic field of the inductor 
returns to its original state as soon as current 
flows through the coil and the switch SW again. 
Now the process can start over again if the 
switch Is opened. 


The diode D prevents the capacitor Cout 
from discharging during the time the switch 
is closed and connected to ground. If this 
Is done in a permanent loop, it results in an 
output voltage greater than the input one. 


To control the timing required for the boost 
mode operation and to give a stable output 
voltage, we can have a look at Figure 6, which 
shows the internal blocks of the DC/DC 
converter IC. The integrated switch — here in 
form of an internal FET — connects the induc- 
tor output to ground. To generate the appro- 
priate timing for the internal FET the output 
voltage is compared against a Vref voltage 
— in this case, 1.238 V. This means we can 
calculate a voltage divider that connects to 
the FB (feedback) input that will be 1.238 V if 
our output is at 12 V or 5 V. If the voltage at the 
feedback pin is higher than 1.238 V, the inter- 
nal logic will try to lower the generated output 
voltage till the feedback pin is at 1.238 V. If the 
voltage is below 1.238 V, this will lead to an 
increase of the output voltage until 1.238 V are 
reached again. Internally, there are protection 
measures that shall limit the amount of current 
through the internal FET, provide a undervol- 
tage lockout, and should shut down the DC/ 
DC converter if the IC's temperature gets to 
hot. This shows the basic principle behind how 
the DC/DC converter operates. 


Overcurrent and protection 

If the output of the DC/DC converter drives 
high loads or even a short circuit, this will lead 
to overstress in the internal FET and structures, 


























Figure 6: Internal blocks of the DC/DC converter. 


resulting in the IC’s sudden death. To avoid this 
there are two places where protection can be 
added, in front of the DC/DC converter and at 
its output. As a fast solution with less compo- 
nents, it might be obvious to limit the current 
and power delivered to the DC/DC converter. 
As a protective element, a polymeric positive 
temperature coefficient device, also known as 
resettable polyfuse, was inserted to limit the 
current in front of the DC/DC converter. This 
may seem like a fast and cheap fix to protect 
the DC/DC converter, but based on the princi- 
ple of how a DC/DC converter works, this is 
will generate new unwanted side effects. For 
educational purposes, a resettable polyfuse 
was added to the PCB. This protected the DC/ 
DC converter from short-term damage, but 
generated unwanted oscillations. Figuring out 
the reason does not require any measurements 
or a test build, just careful thinking. A resettable 
polyfuse limits the current flow by increasing its 
internal resistance with rising temperature. As 
the fuse itself has a defined resistance, current 
flowing through it will raise its internal tempera- 
ture. As a result, the higher the current through 
the fuse, the higher the temperature gets and 




















* Only for Auto-Retry Variant (TPS259621) 


Figure 7: Internal blocks of the eFuse. 


the resulting resistance inside the fuse. This 
resistance will in the end limit the amount of 
current that will pass through the fuse. 


Assuming the DC/DC converter operates at 
a high output load, this also leads to a high 
input current. The polyfuse will now get warm 
and increase its resistance limiting the current 
that will flow. The increased resistance of the 
polyfuse will now also lead to a higher voltage 
drop and result in a lower input voltage for the 
DC/DC converter. The DC/DC converter now 
has a limited current and is prevented from 
destruction but now needs to maintain the 
output voltage and drawn power with an even 
lower input voltage, resulting in more current 
required to for its operation. The increased 
current demand will lead to further increa- 
sed resistance in the polyfuse and will lead 
to an increase in voltage drop across the fuse. 


This leads again to a lower input voltage for the 
DC/DC converter. At a certain point, the input 
voltage will drop below the threshold of the 
under-voltage lockout and the DC/DC boost 
converter will switch off. While switched off, 


the current draw is decreased. This enables the 
polyfuse to cool down and lower its resistance. 
Also, this leads to a lower voltage drop on the 
polyfuse, resulting in a higher input voltage 
for the DC/DC converter. The DC/DC conver- 
ter will restart, and this loop will start again, 
leading to an oscillation. This will also affect the 
output voltage. As with the oscillation, this also 
results spikes and other non-smooth compo- 
nents added to the output voltage. 


If adding a polyfuse at the input is not an 
ideal solution, adding a fuse to the output is 
one. This would be a simple approach for a 
single voltage and a single current limit. With 
two output voltages and two different current 
limits, a single poly fuse would not be able to 
provide defined protection for both voltages 
and currents. A more versatile solution for this 
problem, especially with changing voltages 
and currents, can be an eFuse, which has 
already been featured in an Elektor online 
article [2]. After looking around for eFuses 
that would fit for 5 V to 12 V input voltage 
and would be able to handle 0.5 A to 2 A, 
the Texas Instruments TPS259621DDAR was 
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a. a 


Figure 8: Damaged flat battery being round. 


chosen. As you can see in Figure 7, those 
devices offer more than just simple overcur- 
rent protection. They also can be used for 
overvoltage and under-voltage protection. As 
you can see in Figure 2, we already have a 
switch to change voltages. As the current limit 
is also done with resistor values and changed 
with the set voltages to protect the DC/DC 
converter, having one switch that is able to 
change two independent channels enables us 
to set the output voltage and the current limit 
at once. These switches, which exist and were 
used for this project, offer a modern solution 
for adjustable overcurrent protection. 


Lithium batteries: the easy to 
recharge and flammable ones 
Today, most portable electronic devices use 
lithium-based batteries. Due to advances in 


3.3u 


Bat |e! = 


+5V IC3 BQ24092DGQR 
© 






IN 


œ ISET TS 


7 


—_ 


Figure 10: Schematic DIY LiPo Supercharger Kit. 
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Figure 9: Damaged mobile phone battery. 


battery technology, those cells have increa- 
sed power density per volume and per 
weight. While older solutions like NiCd and 
NiMh need more complex circuitry to charge 
and detect the end of charge, lithium-based 
solutions are simpler. If the cell is not comple- 
tely depleted and has a remaining voltage of 
around 2.5 V, recharging is done with a CC/ 
CV approach — constant current first, with 
an end of charge voltage, and stop charging 
if a defined voltage is reached. For lithium 
ion and lithium polymer, this is typically 
415 V. The BQ24092DGQR does exactly this 
during the charging of an attached battery, 
applying a limited current up to 1 A until the 
cell voltage reaches 415 V. Also, the chip 
includes a charge timer that will, after a given 
amount of time, stop charging, in case the 
battery does not reach 415 V. 
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An additional protection, optionally suppor- 
ted by the charging IC, is thermal monitoring. 
High-quality chargers and battery packs 
include thermal monitoring, usually a thermal 
resistor, to prevent overheating of the batteries 
during charging. Due to the versatile use with 
different lithium battery types and brands, it 
is not useful to implement it here. If for some 
reason this monitoring is not used, a resistor is 
installed instead, which allows the charger to 
operate without thermal monitoring. Just make 
sure you design the right resistor; otherwise, 
no charging will happen. Attaching incompa- 
tible lithium-based batteries, like lithium-ion 
phosphate (LiFePo), can cause the battery to 
catch fire. Be sure to use high-quality cells, as 
a damaged one will start expanding or even 
get hot and possibly catch fire. Figure 8 shows 
damaged lithium batteries that have expanded 
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from their original flat size into an almost round 
shape. Figure 9 shows a damaged cell from a 
mobile phone that also expanded slightly with 
enough force to disassemble a glued mobile 
display from its chassis. 


Final specifications 

With the addition of the eFuse to the circuit 
diagram, the parameters for the eFuse also 
had to be set. The set values are 1.5 A at 5 V 
and 0.75 A at 12 V, as this is a safe range 
for the DC/DC converter. Something also 
to be set is the charging current used for 
the attached battery. The BQ24092DGQR 
offers up to two charging current settings, 
depending on the configuration of the pins 
ISET and ISET2. As ISET2 is tied to ground, 
it means the chip will use the current setting 
from ISET, and with 536R this results in 1 A 
charge current limit for the attached battery. 
Be sure to attach a battery that will handle 
the charge current well. 


A bit of feedback and 

PCB finalization 

After the eFuse was added to the design, 
one thing was to be discussed. The original 
schematic had no optical indication if the 
output voltage was set to 5 V or 12 V. 
GreatScott! and Elektor concluded that an 
additional LED, as an indicator, would add a 
lot to the product's usability. Also, we felt the 
optical feedback would help to avoid acciden- 
tally connecting 12 V to a system that can only 
handle 5 V. The added circuitry to indicate 12 V 
works with an LED and two resistors. This 
lets the LED only light up if 12 V are present 
at the output. 


The second PCB revision worked as expected. 
The next steps were to finalize the design, add 
the last changes to the text and logo, place 
references in the proper places, and hand 
all the material over to production. Figure 10 
shows the final schematic for the DIY LiPo 
Supercharger Kit. Figure 11 is the schematic 
for the USB-C BoB. 


From handcrafted 

to mass market 

Developing products and building prototypes 
inhouse is bit different than producing them 
through automated facilities and service provi- 
ders. Something | have not mentioned yet is the 
small USB-C BoB (Figure 12) that is mounted 
on the main PCB and has its own project 
number. As a USB-C connection for power 
and data can not only be useful for this product, 
a small PCB was also routed and produced to 





USB-C High-Speed BoB 
Corrected 2-12-2019 
191200-1 

v1.0 


Figure 11: Schematic USB-C BoB. 


be reusable. All major connections for USB2.0 
speed and power have been brought to the 
three edges as castellated holes. 


This meant that they were convenient to 
use, but not so easy to produce. Individual 
PCBs were so small that machines had 
difficulty processing them. To solve this 
problem, the manufacturing company had 
to take some technical measures to make 
them processable with their machines. 
Nevertheless, they were produced and are 
included in the kit. But making a small PCB 
with three sides of castellated holes means 
first checking with the manufacturer and 
getting a quote for additional manufacturing 
fees. Also having an SMD DIY kit requires 
the components to be packed or organized 
inside the kit. As this requires some manual 
labor, costs can add up. It can be cheaper 
in the end to offer a PCB with completely 
assembled parts rather than just offering the 
kit with parts. In this special case, because 
an SMD soldering exercise is intended, the 
ICs with a footprint that cannot be done 
with just a soldering iron are pre-mounted. 
Giving your Gerber files and pick-and-place 


> DELEKTOR 
è 191198-1 
elektor(2labs 
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do BE ® 





Figure 12: USB-C BoB. 


data to a manufacturer can add surprises 
to the process. 


At almost the final stage of the process, 
we received a prototype. While resistors, 
inductor, LEDs, and all other mechanical 
parts were packed correctly in bags, the 
PCB came with a small surprise. While the 
components were pre-assembled as expec- 
ted, there seemed to be a problem with the 
solder paste. The solder paste layer for the 
PCB — something most of us that still build 
our PCBs manually have not touched — 
was exported as if all components would 
be placed. This results in solder past applied 
to all the pads across the PCB, making solde- 
ring components unnecessary had and 
complicated. Figure 13 shows the result and 
gives an impression of the added difficulty. 
This required a new set of Gerber files with 
adjusted paste layer, so during manufacturing 
only the pads needed for the pre-assembled 
components will have solder paste applied 
to them. For the production also getting 
the SMD parts in the right amount packed 
into small bags is something you should 
discuss in advance with your manufacturing 
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Figure 13: PCB with the wrong soldermask applied. 
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and service provider. Those tasks are labor 
intensive and can add unexpected costs to 
your project. 


A Box and a manual 

Time to have a look at the final product. 
Figure 14 shows the boxed kit. After all 
parts for the kit are produced and packed, 
just shipping a bag and a short manual is 
not sufficient. If you move from handcrafted 


prototypes to mass-market production, you 
Figure 14: DIY LiPo Supercharger Kit retail box. Figure 15: DIY LiPo Supercharger Kit included must also consider a packaging option and 
parts. 





how to provide your customer with a manual. 
Depending on the countries to which you are 
shipping products, there apply certain regula- 
USB-C PD AND REQUIRED RESISTORS tions for printing manuals in the appropriate 
languages. For the DIY LiPo Supercharger 
Kit, you get both a printed QR Code with a 
link to the instructions and all the required 
components (presorted in labeled bags). 
Including only the QR code enabled us to 
save on resources and help keep the planet 
a bit greener. Refer to Figure 15 to see what 
Is inside the Kit. You can watch a construc- 
tion video from GreatScott! on YouTube [3]. 


While there is a USB-C connector attached and charging from a classical 5 V 1A 
supply with USB-A output and a suitable cable works, this is not the case for USB-C 
PD ones. While with micro-USB we can just grab VCC and Ground to get power, 
USB-C PD changes this. The GreatScott! LiPo Supercharger DIY Kit has been 
designed according to the proven formulas regarding Micro-USB connections, 
ignoring the fact that for the USB-C PD supplies two additional resistors are required 
for power negotiation. This means that USB-C PD adapters will refuse to provide 
power to the board. 


em» 


COMPONENT LIST DIY LIPO SUPERCHARGER KIT 





Resistors Ca 10s) 50) X7R, SMD 1206 
R1 = 84.5 k, 196, 0.25 W, SMD 1206 C10 = 10 n, 5 96, 50 V, X7R, SMD 1206 
R2 = 158 k, 196, 0.25 W, SMD 1206 C12 = 470 n, 10 96, 50 V, X7R, SMD 1206 
R3 = 18 k, 196, 0.25 W, SMD 1206 C13 = 330 p, 20 96, 35 V, SMD 10.3x10.3 
R4 = 13 k, 196, 0.25 W, SMD 1206 
R5,R7 = 1k, 1%, 0.25 W, SMD 1206 Inductors 
R6 = 536 Q, 196, 0.25 W, SMD 1206 L1 = 3.3 y, 20 96, 3.5 A, 35 mQ, SMD 
R8,R9 = 1.5 k, 196, 0.25 W, SMD 1206 7.3x7.3x4.5mm 
R10 = 10 k, 196, 0.25 W, SMD 1206 
R11 = 100 k, 196, 0.25 W, SMD 1206 Semiconductors Others 
R12,R13 = 1.2 k, 1 96, 0.25 W, SMD 1206 D1,D2 = SL22-E3/52T, SMD SMB PC1.PC6 = Header pin, male, 1x1 
R14 = 4.7 k, 196, 0.25 W, SMD 1206 LED1 = 11-21/GPC-AM2P1/2T, LED green, SMD  S1- Switch DPDT, THT, 91x3.5 mm 
R15 = 1.8 k, 1%, 0.25 W, SMD 1206 1206 (K2-2235D-F1) 
LED2,LED3 = 15-21SDRC/S530-A2/TR8, S2 = Switch SPDT, 250 VAC, 3 A (XKB, 

Capacitors LED red, SMD 1206 SS-12D06L5) 
C1= 3.3 n, 5 96, 50 V, NPO, SMD 1206 IC1 = TPS61085DGKR, SMD VSSOP-8 K1 = USB-C BoB, Elektor 191200-1 
C2,C7,C11 = 100 n, 5 96, 50 V, COG, SMD 1206 IC2 = XB8089D, SMD SOIC-8-EP PCB 191188-1 v21 
C3,C4,C6,C8,C9 = 10 y, 10 96, 25 V, X7R, IC3 = BQ24092DGQR, SMD MSOP-10-EP 

SMD 1206 IC4 = TPS259621DDAR, SMD SO-PowerPad-8 


em 


COMPONENT LIST USB-C BOB @ 191200-1 @ 

Resistor Others ES [383/10:2 NL. 

R1 = 100 k, 1 96, 100 mW, SMD 0603 K1 = USB - Type C, Receptacle, B ntm E 
current rating 3 A, SMD/THT 

Capacitor PCB 11200-1 v1.0 


(eom ce, 100-7 XA 7R SMD 0603 
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And if you are doubtful about soldering SMD 
components, checkk out his video tutorial [4]. 
A rechargeable battery is not included. But 
you can grab a suitable one from a online 
shop, or you can use a good one you have 
on hand. Make sure the battery can handle 
1A charge current and is a single-cell lithium 
ion or lithium polymer. 


When it comes to assembly, take your time 
and be patient. SMD components, even if 
1206, have Ninja-like abilities when they fall 
off the workbench or hide behind parts on 
your desk. After you finish building and testing, 
the DIY LiPo Supercharger will be ready to go. 
The switch S2 on the PCB is used to connect 
or disconnect the battery from the DC/DC 
converter. This enables you to turn the output 
off and it also saves power. Then even an 
unloaded DC/DC converter can consume 
up to a few mA of current. After connecting 
a battery, the first thing is to let it completely 
charge. On the DIY LiPo Supercharger, LED1 
indicates that the supplied voltage from the 
USB-C connector Is within a valid range. While 
charging, you can see that LED2 will light up. 
It does not light up when the battery is fully 
charged. This means your portable energy 
source Is now ready to use for your projects. 


The journey is the reward 

Having a portable power source at hand, 
especially with switchable output voltages, Is 
extremely useful. Figure 16 shows a Raspberry 
Pi Zero powered by the DIY LiPo Superchar- 
ger Kit. If you have a tight budget and don't 
want to solder anything, you can stick to hot 
glue, sticky tape and flying wires and cheap 
Chinese components. With this kit, you 


Questions or Comments 

Do you have any technical questions 
or comments about his article? Email 
the author at 
mathias.claussen@elektor.com or 
contact Elektor at editor@elektor.com. 


— WEB LINKS 


can assemble everything 
yourself, and the DIY 
SMD soldering experience 
makes it especially appea- 
ling. Having an off-the-shelf 
solution that just pops out of a 
plastic bag and is ready to be used is 
much less fun than building your 
own. Building this kit is more like 
tackling a Lego project. You do not 
want the readymade design to pop 

right out of a box. The journey is the 
reward, and when you are finished, 

you have a handy portable power 
source that can be used for the 
next projects. 





Looking for schematics? 
You can find them on this 
project's Elektor Labs 
page [5]. If you need 
support, you can also 
leave a comment there. 
I< 
191188-B-01 


Contributors 

Idea: GreatScott! 

Design: Ton Giesberts 
Author: Mathias Clauf3en 
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Figure 16: Raspberry Pi Zero 
powerd by DIY LiPo Supercharger Kit. 


Editors: Jens Nickel and C. J. Abate 
Illustrations: Patrick Wielders 
Layout: Giel Dols 


> GreatScott! - DIY LiPo Supercharger Kit 
www.elektor.com/diy-lipo-supercharger-kit-by-greatscott 


» Weller WE 1010 Digital Soldering Station (Education Kit) 
www.elektor.com/weller-we-1010-digital-soldering-station-education-kit 


» Fumetractor with LED Light 


www.elektor.com/fumetractor-with-led-light 


[1] Vibrator (DC/DC Converter): https://en.wikipedia.org/wiki/Vibrator. (electronic) 





[2] S.Cording, "The Modern Fuse,’ ElektorMagazine.com, 8/12/2020: www.elektormagazine.com/articles/modern-fuse 
[3] GreatScott!, "DIY LiPo Supercharger! (Charge, Protect, 5V/12V Boost V2),’ 12/6/2020: https://youtu.be/6LxRnf6sQNQ 


[4] GreatScott!, "How to Solder Properly: Through-hole (THT) & Surface-Mount (SMD);' 9/3/2017: 
www.youtube.com/watch?v=VxMV6wGS3NY 


[5] Elektor Labs page: www.elektormagazine.com/labs/diy-lipo-supercharger-kit-by-greatscott 
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Reflections on Six Decades of Electronics 
















— APRIL ERORE 


By Jens Nickel (Elektor) 





oixty years of Elektor magazine! 
That is quite a long time for 
a magazine dedicated to 
electronics, a subject that 
evolves so quickly that it can 
be hard to keep up with all the 
developments. Since 1961, we 
have not only reported on the 
latest technologies, devices, 
boards, and components (with 
the typical mixture of theory 
F and practice), we have shared 
EEN TRANSISTOR 4 mm" our ideas and projects with 
E T EN professional electrical engineers 
DISTORSIEMETER | A | p" ES  andmakers alike. To mark 
" 1 a [o P our anniversary, we recently 
RUISINY . JE M | n i asked several of our authors 
= ""-——— P and editors to select what 
TURING VA Dus ) F they consider to be the most 
LICHTNET C " | interesting projects and articles 
| T wr from the last six decades of 
TOONGENERAIOR os. Elektor! 


15 meer dan 5O schakelingen 


MAAK ZELF EEN 
ECHOAPPARAAT 


TRANSISTOR 
VADEMECUM 


TENDER MET 


Check out the first cover of Electronica Wereld. Later, the 
name was changed to Elektuur, which means something like 


"e-reading" or "e-lecture/ In 1970, the first German edition was 
published under the name Elektor. 
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Our well-known magazine was launched in the Netherlands in 
April 1961. There is probably no one better to tell you about it than 
Harry Baggen, who spent decades as the Editor in Chief for the 
Dutch edition and also worked for many years as magazines Inter- 
national Editor in Chief. 


"When Bob W. van der Horst started his own electronics magazine under 
the name 'Electronica Wereld', he had set himself the goal of making 
a better magazine than the existing magazines. He wanted to remove 
the mystical veil around the subject and show mainly the practical 
side. In the beginning, the magazine consisted mainly of a collection 
of product reviews and technical background articles, but after a few 
years, the purely practical side prevailed. And so it has remained to 
this day. No endless theoretical treatises, no: practical circuits with 
contemporary components, that was and is the aim." 


"Bob also always wanted to be at the forefront of new components. In 
the first years, it was still mainly tube circuits that appeared in the 


A passion for taking a practical approach to electronics is in 
Elektor's DNA. From day one, we have wanted our readers to 
be able to build and learn at the same time. As a result, Elektor 
community members have always loved our projects. 


magazine, but soon their place was taken by semiconductors. Apart 
from transistors, FETs were also frequently used. Elektor was soon known 
as stubborn, crosswise, innovative. Exactly what Van der Horst wanted 
to achieve!" 


The first edition included more than 50 circuits, for example a 
distortion meter and a single transistor transmitter (free download 
www.elektormagazine.com/210025-01). And there were many, 
many more projects to come! You will find a nice selection of 
projects on the next pages, together with some commentary from 
experts and authors. 


Elektor members can download these articles via the supplied 
weblinks. To celebrate Elektor’s 60th anniversary, we are making 
seven of these “Editors’ Picks” freely available until June 30, 2021. 
Enjoy! 






210025-01 
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Years of Electronics 





Havvy Baggen 
(Former Editor-in-Chief) 


Edwin Amplifier (1975) 

From its early years, Elektor was known for its unusual homebrew 
audio projects, and that has remained true even to the present 
day. A “pioneering” design in 1970 was the Edwin Amplifier, which 
was a very simple audio amplifier by today's standards that 
featured a quiescent output stage. It became a classic and is one 
of the most copied audio amplifiers of the last century. 


www.elektormagazine.com/magazine/elektor-197509/57506 


Elektorscope (1976) 

In the seventies, oscilloscopes were almost unaffordable for 
hobbyists. This was a good reason for the designers of Elektor 

at the time to develop and publish a homebrew oscilloscope. 

In those days, this was a tough job, especially because the 
oscilloscope tube, the associated control and high voltage had 
to be carefully tuned while many of these parts (especially the 
tube) were very hard to come by. Nevertheless, it was possible to 
present a circuit that was sure to be rebullt. 


www.elektormagazine.com/magazine/elektor-197612/57794 


Microprocessor-Controlled Frequency Counter (1985) 
In the early 1980s, Elektor presented a series of measuring 
devices of which the microprocessor-controlled frequency 
counter was the highlight. In terms of features and functionality, 
this gem could easily compete with professional equipment. It 
had a frequency range up to 1.2 GHz, autoranging, foil keys for 
operation, and an alphanumeric display. 


www.elektormagazine.com/magazine/elektor-198501/45402 





Plotter (1988) 


In a time when plotters could only be found in laboratories 

and engineering offices, Elektuur published the design of a 

very simple self-built plotter. The parts for the plotter cost a 
pittance compared with a real plotter, and felt pens were used 
for the drawing pens. Later, an HP-GL driver for the plotter even 
appeared. 


www.elektormagazine.com/magazine/elektor-198805/47339 








Surround Sound Processor (1995) 

In a time when surround-sound devices were just appearing 

on the market, Elektor came up with a homebrew circuit. The 
circuit worked without special Dolby ICs, because they were 

not available for homebrew, but the Elektor lab still managed to 
design a decoder with conventional means that expanded the 
existing stereo sound with a mid and surround channel. The PCBs 
were in short supply. 


www.elektormagazine.com/magazine/elektor-199502/33270 
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The decoder's electronic design is brilliant 1980s-style with 
nothing but cheap components, including CMOS ICs, the 
TBA1208S, and a lot of p-n-p transistors. No microcontrollers or 
other new-fangled stuff — the glory days of the Elektor-invented 
"TUN & TUP' relived. 


Filmnet changed their picture scrambling format several 

times during the months after the E/ektor publication but got 
defeated time and again by nifty updates to the Elektor decoder. 
These tweaks | was honoured to publish in a few instalments 

in the series From the Satellite TV Desk. After three updates 

and matching texts for the telephone exchange ladies, P.N.P. 
Wintergreen came up with his ingenious "learn & adapt" add-on 
circuit based on a one-capacitor sample & hold. From then on, 
owners of a fully updated Elektor Filmnet Decoder did not even 





Jan Buiting notice scrambling-mode changes. It was sublime hacking of a 

" - 5 very expensive scrambling system sold to the Filmnet owners 

(B ook EAirov, Fovwev EAitov-in- as being “highly problematical to compromise” In later years, 
" " a the BBC World TV Service's "SAVE" scrambling and several 
Chief of Eng} ish Edition) DMAC/CMAC/Irdeto sat-TV stations also had to succumb to 


Elektor hacking with equally glorious results, massive readership 


resonance, and a Q-factor that you can only dream of today. 
ATN-Filmnet Decoder (1989) 


Never in my 36-year stint with E/ektor did | experience and enjoy | know the designer personally, but he shall remain anonymous. 
more enthusiasm, praise, and general “resonance” from the DIY He is a true electronicist though. “Problematic? — No such entry 
electronics community than with the publication of the “ATN- in my dictionary of electronics.” 


Filmnet Decoder" back in 1989. This brilliantly engineered project — www.elektormagazine.com/magazine/elektor-198903/47520 
immediately set E/ektor as a leading source of "educated, witty, 


and refined" publications on how to hack pay-TV channels with 
pan-European coverage, all thanks to a few Astra and Intelsat 
satellites. In Scandinavia alone, an estimated 20,000 Elektor 
Filmnet decoders were in use. "Just for private and experimental 
use, Jan" — of course! And: "Our winters are long & dark, Jan" — 
of course! 


Both the project engineering and the article publication were 
highly unusual within Elektor. Firstly, the project did not run in the 
Dutch Elektuur for fear of legal ramifications. Secondly, also for 
fear of lawyers on the phone or on the doorstep, the PCB wasn't 
listed on the erstwhile "EPS" pages (now Elektor Store). Thirdly, 
the designer published under the pseudonym "P.N.P. Wintergreen’, 
after a character in Joseph Heller's book Catch-22. 





What was considered an oddball article by the publishers at 
Elektor in fact triggered thousands of hobbyists all over Europe to 
start building the decoder. The word soon spread that Filmnet had 
been hacked big-time by Elektor. Elektor's English edition saw its 
first total sell-out since 1974 and went into a second print run. The 
Dutch were "duly served" by piles of illegal copies of the original, 
English-language article distributed by electronics retailers. 
Elektor's telephone exchange ladies read out a scripted text for 
weeks on end, in response to a flood of calls. PCBs "made by 
someone" were sold illegally in stores and on big radio amateur 
rallies in the UK, Germany and Holland. 
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ff | (y yeovs of Electronics 





Luc Lemmens (Elektor Lab) 


BASIC Computer (1987) 
80C32/8052AH-BASIC single-board computer (1991) 
8051/8032 Assembler course (1992) 


One of the first larger projects | supervised at the Elektor Lab 
was the 8032/8052 Single-Board Computer published in May 

1991, as a successor to the popular 8052AH-BASIC board from 
1987. It wasn't that large in terms of hardware, but this article was 
followed by an eight-part course on assembly language using this 
board that was followed by many readers. For those who didn't 
want to learn assembler, Intel's 8052AH-BASIC microcontroller 
could also be used on this board. With a simple program its 
internal BASIC-interpreter (its complete program memory) could 
be ‘illegally’ copied to external EPROM. 
www.elektormagazine.com/magazine/elektor-198711/47252 
www.elektormagazine.com/magazine/elektor-199105/32356 
www.elektormagazine.com/magazine/elektor-199202/32571 





GBDSO Gameboy Digital Sampling Oscilloscope (2000) 
The Nintendo Gameboy Digital Sampling Oscilloscope (GBDSO) 
presented in the October 2000 issue was another smashing hit 
and was one of the first completely assembled modules available 
in the Elektor Store. Initially, we were only going to have one batch 
produced, but in the end, the demand turned out to be much 
greater than we had expected. | lost count of the numbers of 
"very, very last batches" we were ordering. Apparently, there were 
many readers who still had an unused Gameboy lying around 
and wanted to give it a second life as a portable measuring 
instrument. 


www.elektormagazine.com/magazine/elektor-200010/16868 


Programmable Odour Generator (1986) 

Elektor's famous annual Summer Edition was the double-sized 
issue for the months July and August, filled with over a hundred 
small, often remarkable (sub-) circuits, tips and tricks. A standard 
feature was the ‘joke circuit; of which the programmable odour 
generator IC (CD4711) in 1986 is probably the most famous. Years 
later, we still received questions from readers whether we had 
contact details of the manufacturer Odorant Elektronik GmbH in 
Cologne. 


www.elektormagazine.com/magazine/elektor-198599/47015 





Jews Nickel (Editor-in-Chief) 


Embedded Linux Made Easy (2012) 


| was very proud in 2012 as the newly appointed German Editor in 
Chief: Compared to the previous year, we were able to increase 
the free paid circulation by 2096. But it wasn't my doing. It was due 
to a title project that was ahead of its time. Our author Benedikt 
Sauter and his team had developed a compact board that ran 
Linux and was outrageously cheap for the time — just €50! 


www.elektormagazine.com/magazine/elektor-201205/19861 a 


Here Comes the Bus! (2011) 

In my first years as Elektor editor, | was the only one who didn't 
tinker. My “fear of contact” with practical electronics urgently 
needed to be dismantled. The international Editor in Chief at the 
time therefore had me write a column about the guys in our lab. 
However, he didn't realise what an avalanche he was setting off! 
Since there wasn't much new in the lab, | soon focused on a bus 
system that could be used for all kinds of controls. The feedback 
was overwhelming! | got hundreds of mails, and soon a group of 
a dozen innovators came together to define the specifications of 
the ElektorBus. But, of course, there was also a lot of abuse. (I got 
feedback like “amateurish” and "a design from the 60s.’) 


Later, several projects were based on the bus, and it was 





o 
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also used in a diploma thesis. | got a call from a building 

services company that wanted to develop modules. Only the 
aforementioned guys from our lab refused their affection for the 
project. And so, to the chagrin of many readers, the major project 
quietly put to sleep. 


www.elektormagazine.com/magazine/elektor-201101/19522 


XMEGA Web Server Board (2013) 

My passion for developing was admittedly awakened. Two years 
later, | was able to design my own microcontroller board together 
with a couple of professional engineers. We put an Xmega and 

a lot of peripherals on it, but in the end, the whole thing sold 

for around €100, not even including the display. The engineers 
gave us their development time, but they had made boards and 
prototypes for about €1000. We couldn't even recoup these costs. 
A flop! And | had put a lot of effort into the software, even creating 
a framework with the Embedded Firmware Library that abstracted 
not only from the controller hardware but also from the board 
wiring. One of our readers and | had a lot of programming fun in 
the process. | got feedback from readers who called my approach 
“ingenious. Still others thought the construction was simply 
superfluous. But in the end, what counts is that | learned a lot 
myself and perhaps also gave the community a few ideas — that's 
what Elektor is all about! 


www.elektormagazine.com/magazine/elektor-201310/23489 
www.elektormagazine.com/magazine/elektor-201305/20590 
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Clemens Valens (Elektor Loo) 


EPROM Simulator (1989) 

When | started in what is now called embedded system design, | 
quickly discovered that reprogramming EPROMs was rather time 
consuming. Therefore, when Elektor published the 1989 EPROM 
simulator, | immediately built one. Uploading firmware to a target 
board became as simple as copying a file to the PC's parallel 
printer port. Much faster than Arduino today and not involving 
bootloaders, my colleagues and | used it for years. Until the PC's 
parallel port disappeared and microcontrollers with built-in flash 
memory took over... 


www.elektormagazine.com/magazine/elektor-198912/47689 


E: 
i-Pendulum (2016) 


The i-Pendulum may not be the most useful device ever 
published, but what an excellent project it was! When placed 
on a horizontal surface and after being switched on, it would 
suddenly jump up, stand on its top and 

remain motionless. 
My job was to 
produce the 
Elektor article 4 
and build the 

prototype. The 

design by Jean- 
Sébastien Gonsette was 
very well done, but hand- 
soldering the motor driver IC 
was hell. Somehow, | managed and 

ended up with a working device. When | showed it to a friend, 
he fell on the floor laughing. It was one of the most rewarding 
responses | ever got on something | built myself. 








LEE ELE. 





www.elektormagazine.com/magazine/elektor-201605/28959 


Summer Circuits/Halfgeleidergids 

| only used to buy Elektor Magazine when it presented something 
that really interested me, except for the Summer Circuits double 
issue which | bought every year with my eyes closed. Besides 
the 100+ circuits, | also liked the advertisements, especially the 
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Years of Electronics 


catalogue-like multi-page ads listing hundreds of components. 

| continued buying it without looking until 2007 when, for the 
first (and last) time, it had a theme: robotics. 95% of the circuits 
concerned robotics and | didn't like any of it. The year after, 
instead of buying the summer issue, | started working for Elektor. 


www.elektormagazine.com/magazine/elektor-198499 
www.elektormagazine.com/magazine/elektor-200707 


Formant (1977) 

Too young when it was published, too poor when | became 
interested, | finally did get my hands on a Formant music 
synthesizer when two friends together bought an almost working 
one. It quickly ended up in my bedroom where | rewired it, 
replaced the envelope generators by a design from a competing 
electronics magazine, and used my brand-new home-built digital 
frequency meter to calibrate everything. Together with my friends 
we played the revived machine for many, many hours. 


www.elektormagazine.com/magazine/elektor-197704/57836 
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Mathias Claugen 
(Elektov Loo) 


Logic Analyzer with Atari ST (1989) 

| started with an Atari ST as my first computer, so it was quite 
impressive to see in the archive that logic analyzers were 
homebuilt back in the days with those machines. Using only 
a bunch of logic chips and well-designed software, your ST 
became an eight-channel logic analyzer with 2-MHz sample 
frequency. This was realized by clever use of the ST external 
HDD interface. The idea, released in 1989, was reinvented 
almost two decades later with the Saleae Logic 8. Instead of a 
reused hard disk interface and some 74HC chips, the Logic 8 
used a microcontroller and USB. Of course with some higher 
specifications for the sampling rate and advanced software, but 
the principle remained the same. 


www.elektormagazine.com/magazine/elektor-198910/47664 
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Junior Computer (1980) 

To stay a bit in this retro wave, the MOS6502 and its derivates 
still have developers around the world who enjoy building code 
or systems around this chip. This one has been the CPU of many 
famous systems, like the Nintendo NES, Atari 800, Apple II and 
in a modified version in the C64. In 1980, E/ektor published the 
Junior Computer, a 6502-based device that allowed for the entry 
in the world of microprocessors. With its 1-MHz clock speed, 1 KB 
of RAM and 1 KB of ROM, it was slower and less powerful than 
an today's ATmega-based Arduino; but back in the days, this 
was something you could build and fix yourself. Even three- 
decade-old, 6502-based systems are still around, and with the 
Commander X16 from David Murray, even a new design based 
on this CPU is on its way. And if you like to build your own 
6502-based computers, the CPUs are still in production, even 
today. 


www.elektormagazine.com/magazine/elektor-198005/44396 





E-Lock: The First Elektor Chip (2014) 

Speaking of microchips, even Elektor produced its own chip. In 
2014, the E-Lock chip showed up, integrated wired Ethernet, 
ADC, lC, DAC and some GPIO with secure communication and 
encryption. Equipped with hardware encryption and security 
elements, it was meant to be used for the upcoming loT. 


This is one of the curious Elektor projects, as some internals of 
this chip remained a mystery. We may never know what core they 
used and how the internal registeres worked. Newer chips like 
the ESP8266 or some from WiZnet have taken its place. Wired 
Ethernet has still its place but users now demand more and more 
loT wireless solutions. 


www.elektormagazine.com/magazine/elektor-201404/26214 


Elektor Proton Robot (2011) 

Something that was in the office and sadly collected dust for a too 
long time it the Elektor Proton. A self-driving robot developed as 
education platform for students. With a modular design based on 
an I^C bus, it is designed to give a fast and simple entry into the 
world of robotics with a whole set of features that make it easy for 
beginners and professionals to use it for own purposes. As now 

a decade has passed from its first appearance in 2011, the Proton 
left in the office could use an overhaul with todays new sensors, 








vision and a new powerful, maybe Wi-Fi-enabled, MCU at its 
heart. Thanks to the used I?C bus this should not be an issue. 


www.elektormagazine.com/magazine/elektor-201105/19586 





C.J. Abate 
(Content Divectov) 


Many of you have likely gone down the "YouTube rabbit hole.” You 
know how it works: you start watching Clemens Valens's GitHub 
video (http://bit.ly/elektor-github) on the ElektorTV channel after 
dinner one night and then realize two hours later that you are 
engrossed in a video about building an off-grid cabin in Alaska. 
But have you ever gone down the Elektor magazine rabbit hole? 

| don't have a hard copy of every Elektor magazine in my home 
library, but | do have access to the digital archive. During the past 
several years, l've spent countless hours browsing and clicking 
through the PDFs. One recent evening, after watching an Elektor 
Formant-related video on YouTube, | began searching the E/ektor 
archive to find the first articles about that much-loved music 
synthesizer project. Ninety minutes later, | found myself reading 
the article "Radar Detector" from March 1991. With decades of 
content at my fingertips, it is hard to pick favorites. So, here are 
some articles that | highly recommend because they provide 
handy introductions to a few subjects | find truly interesting. 



















Formant - The Elektor Music Synthesizer (1977) 
This project long predates me. But having heard about it for 
several years, | recently decided to do a little research. Of course, 
you can even find people today making music with Formant on 
YouTube! 


www.elektormagazine.com/magazine/elektor-197705/57847 


Taming the Beast: A Simplified Approach 

to Working with FPGAs (2012) 

Several years ago, long-time Elektor editor Jan Buiting and | 
traveled to California to visit Xilinx. While meeting with some 
engineers and touring the facility, | quickly realized how little | 
knew about FPGA technology. The article, “Taming the Beast,’ is a 
helpful starting point. 


www.elektormagazine.com/magazine/elektor-201212/20012 


The Story of Valves (1984) 

Who isn't fascinated by valves — you know, those "fragile glass 
things with all sorts of complicated-looking bits and pieces 
inside"? This article is classic Elektor. Whether you are an old- 
school electronics buff or you are a sucker for contemporary 
designs that mix high-end electronics with cool-looking retro 
tubes, you'll love this article. 


www.elektormagazine.com/magazine/elektor-198411/45377 
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Programming the Finite State 


with 8-Bit PICs in Assembly dip 






NN Td 


e so you can find what you need. | have 
n | had three books published by Elektor. A 
f rT book or an article along with some hands 
j on practice is a good way to learn how 
things work. You can always experiment 
even if you never build a complete 
project. There is also the opportunity for 
anyone to upload a project to Elektor Labs Online so others can 
copy or improve on their work. Open source software has been a 
spectacular success, Elektor is doing this for electronics as well. 


Mic hel Kuenemann (A uthov) Books by Andrew Pratt: 


www.elektor.com/catalogsearch/result/?q=andrew%2Opratt 


Andrew Pratt 


| discovered Elektor in the mid-80s, and | was astonished by 

the quality of their projects. | built the 6502-based frequency 
counter published in 1985, which ts still working. During my 
electronic engineering studies, | was involved in an amateur 
rocket association. We planned to measure the atmospheric 
pressure variation during the rocket's climb. E/ektor had published 
a very neat project using a pressure gauge sensor and several 
op-amps. The board has finally been successfully integrated in 
the rocket. After my graduation, | created a company and Elektor 
kept on being a premium source of inspiration for me all through 
the years. | discovered the I*C bus and many other technologies 
thanks to E/ektor. Later | could contribute to the magazine with 
several articles related to modeling, like a motor running in bench 
(April 2009) and a ZigBee-based remote control (October 2011). 

| am 58 now, and Elektor keeps on having a big influence on me. 
Happy 60^ anniversary to Elektor and many thanks to the team 
and authors for all the good stuff! 


Articles by Michel Kuenemann: 
www.elektormagazine.com/authors/171/michel-kuenemann GreatScott! 
(Authov, YouTuber) 


For me, it took quite a while before | discovered Elektor. After 
many years of producing YouTube videos about electronics, one 
day a recommendation from a viewer caught my eye. It was about 
a DIY kit from Elektor. The weblink took me to the Elektor website, 
where | spent several hours looking around and noticed that 

the topics covered had some similarities to my own electronics 
videos. A few months later, | was contacted by Elektor and asked 
if we could do some video productions together — the rest is 
history. | became an Elektor reader, and in cooperation with 
Elektor, | produce videos about very different electronics topics. A 
win-win situation for everyone! 








Free Online Article about the DIY LiPo Supercharger Kit 
by GreatScott!: 
www.elektormagazine.com/articles/diy-lipo-supercharger-kit 





AndAvew Pratt (Authov) 


| first read Elektor in the 1970s long before the Internet. Technical 
magazines provided education and useful advertisements about 
components and equipment. Now the Internet provides almost 
unlimited information, so why do we need magazines? Websites 
are convenient, but physical media has many advantages. Elektor 
provides both. The website arranges the information in one place 
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REVIEW 





Siglent Bench Multimeter 
SUM3045xX 





By Harry Baggen (Elektor) 


Every electronics enthusiast will have one or more multimeters. But have you ever 
considered purchasing a bench multimeter instead of a hand-held one? These usually 
offer many more features and a better display. The Siglent SDM3045X is a 44-digit bench 
multimeter with a basic accuracy of 0.02% and many interface options. Here follows our 
impression after having tested it for a few months. 


Anyone who does anything with electronics will have one or 
more multimeters. You can already have one for some 10 euros, 
but for increased robustness, greater safety, more features and 
better accuracy that amount will quickly increase to a few hundred 
euros. The accuracy, in particular, is something that has a great 
influence on the price. 


At home, I've always worked with a simple multimeter. Last year, 
after decades of faithful service, it was finally replaced with a better 
version that has a dual display and, especially, a better accuracy 
than the old one. I have been very pleased with it. When I had the 
opportunity to test a bench version of a multimeter from Siglent, 
Ithough it would be a good idea to compare it to my hand-held 
multimeter. This Siglent is more expensive to buy, but perhaps it 
is worth the additional expense. Which meter is easier to use and 
what are the advantages and disadvantages of each type? 


The Equipment 

This is the smallest' bench multimeter from Siglent, out of a series 
ofthree, but apart from a fewer number of digits and a lower basic 
accuracy, this SDM3045X still offers the same feature set that the 
more expensive versions also offer. If this amount of accuracy is 
sufficient for you, then this model will give you the best price/ 
performance ratio. 


The SDM3045X is provided with a sturdy metal enclosure that has 
plastic protection bumpers on the corners. The carrying handle 
can be rotated into various positions, so that the front of the meter 
can be tilted up at an angle. The enclosure has the same dimen- 
sions as many of the other devices from Siglent (such as the signal 
generators), so that the equipment can be stacked together easily. 


On the front is a clear 4.3" colour display. Below that are six 
soft-menu buttons, the functions of which appear on the display. 
On the right are the usual meter function buttons (most of which 
have a secondary function) plus a set of cursor keys for navigating 
through the menus and the setting of values. 


There are five input sockets (Figure 1), two for the normal inputs, 
two sense inputs for four-wire resistance measurements and a 
current measuring input. On the back we find an IEC mains input 
socket, a USB connector and a LAN connector for connecting to a 
computer or network, and two BNC sockets for external triggering. 
There is also a fuse holder for the current measurement function. 


Measurement Features 

The SDM3045X has, of course, all those functions that you would 
also find on a good hand-held multimeter: voltage and current 
ranges, resistance, capacitance, frequency, dB(m), temperature 
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Figure 2: There is a selection of 
display options. 


Figure 1: There are input sockets for 
four-wire resistance measurements. 


and diode/continuity measurements, auto-ranging and — as is 
now common with the better multimeters — the option to display 
two measurement values simultaneously (for example, AC voltage 
and frequency). The meter has a display that shows a maximum 
of 66000 counts and has a basic accuracy of 0.02% (DC voltage). 
It can make up to 150 measurements/s. The instrument has not 
been designed for use with high-voltage circuits (CAT I (10000 V)/ 


DateTime Measurement 


L 20-11-06 15:37:07 DC Voltage(V 


Time(s) DC Voltage(V) " 
0 1.375 
0.2099876 1.375 
04201563 1.375 
0.6403177 1.375 
0.8403626 1.375 
1.0404632 1.375 




























Figure 3: The meter can be connected to a PC via USB or LAN. 


CAT II (300 V)), but then you wouldn't use such a bench meter in 
an electronics lab for that anyway. The meter can be operated from 
a PC via LAN or USB, or the measurement results can be stored. 


With the voltage measurements you can choose from different 
display options, such as an additional bar display below the value, 
a trend graph or a histogram (Figure 2). There are also various 
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Figure 4: The free software, EasyDMM, for operating the meter and the reading of measurement data on a PC. 
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mathematical functions. Many meter functions have various 
options available. It is too much to mention everything that this 
meter is capable of here, but to give a few examples, in the 600-mV 
range you can choose between an input impedance of 10 MQ. or 
10 GO, with the diode test function you can set the test voltage 
between o and 4 V, and with the temperature measurement you 
can select from different configuration options, depending on the 
type of temperature sensor that is used. It is possible to trigger the 
meter manually or externally, so that it performs a certain number 
of measurements. Furthermore, high and low thresholds can be 
specified to test whether a value is within that range. The internal 
flash memory of1GB can store up to 10,000 measurement results. 


Configuration settings and measurement results can be stored on 
a USB stick, using the USB connector on the front. If you would like 
to connect the meter to a PC then you have the option of either a 
USB or LAN connection (Figure 3). The accompanying software, 
EasyDMM, (Figure 4) is only suitable for Windows, but that will not 
be a problem for the majority of electronics enthusiasts. Both the 
operation of the meter and the storing of measurement sequences 
is possible with this software. As with most of the other Siglent test 
equipment, this meter also uses standard SCPI commands, handy 
for those who would like to put their own test procedures together. 


In Practice 

The biggest difference between this bench multimeter and a 
hand-held multimeter is perhaps the fact that the first is powered 
from the mains. This may look like a disadvantage, but if you always 
use the meter at the same location then you will hardly notice that. 
You give the SDM3045X a position on your lab bench, connect it up 
and then it normally just stays there next to the scope, the power 
supply and the other test equipment. I once kept track of how often 
I actually carried my hand-held multimeter to another location; 
this turns out to beonly on the very rare occasion. Most ofthe time 
I work at my lab bench and that is also where I use the multimeter. 
Since the SDM3045X has been on my lab bench (Figure 5), I have 
barely made use of my hand-held multimeter (I used both whenI 
wanted to make two measurements simultaneously). The 3045X is 
much more stable on the bench than a hand-held DMM and with 
its fold-out support I found the operation of the pushbuttons a lot 
more convenient than a rotary switch. 


It does take a little bit of time to get used to its operation and all 
the functionality, mainly because there are so many configura- 
tion options. And when you switch it on you need to have a little 
patience until the ‘computer’ has started up, this is clearly different 
compared to a hand-held multimeter. But otherwise there are only 
advantages: a big and clear display and just about all the features 
you could imagine for a multimeter. The accuracy is fantastic 
and with AC voltage measurements, the large frequency range to 
100 kHz is also a bonus; most hand-held multimeters don't even 
make it up to the audio range. 


If you require greater accuracy then you can turn to its more expen- 
sive sibling, the SDM3055, which offers an additional digit. However, 
one big advantage of the SDM3045X is that it does not have a fan, 
in contrast to the 3055, and is therefore as quiet as a mouse. The 
accompanying PC software is well-organised and ideal for the 





logging of measurement results. You will have observed already: 
I have barely taken my hand-held multimeter from its storage case, 
this instrument offers so much more! 


Take a Look 

If you are prepared to spend a little more on a good multimeter, 
then I can certainly recommend you to take a look at the SDM3045X 
and all the features that are described in the datasheet. This bench 
multimeter will make an excellent companion, both on the profes- 
sional as well as the hobby work bench, that is capable of so much 
more than a hand-held multimeter, and in my experience is also 
easiertooperateandread. M 
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Figure 5: The SDM3045X feels comfortably at home between the other lab 
equipment, 


Questions or Comments? 
Do you have any questions or comments prompted by this 
article? Send an email to Elektor at editor@elektor.com. 


Contributors 

Text and illustrations: 
Harry Baggen 
Editor: Eric Bogers 


Translation: Arthur de Beun 
Layout: Giel Dols 
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» Siglent SDM3045X Multimeter 
www.elektor.com/siglent-sdm3045x-multimeter 
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DC Current-Sense Clamp 


Hall Sensor + Ferrite Core + Arduino 


By Prof. Dr. Martin OBmann (Germany) 


When you need to measure current flow through a wire, the normal method is to insert an 
ammeter in series with the cable. Using a clamp-on ammeter, or “Amp-clamp,” you dont 
need to break the circuit. The more basic versions of the Amp-clamp can only measure AC 
current flow because they use sensors that respond to AC only (i.e., they work on the same 
principle as a transformer). In order to measure DC current, we can use Hall sensors. 





Figure 1: The magnetic field geometry. 


Before we embark on the design of such a 
project, it's always a good idea to research the 
topic and look at any commercial examples 
already available to see how they are designed 
and how they can be improved. A current 
clamp consists basically of two ferrite core 
halves. The core is composed in such a way 
that the two halves are separated by an air 
gap (Figure 1). The current flowing through 
the wire enclosed by the core has the value nf. 


Mathematical Relationships 

The value n indicates the turns count (The 
number of turns that the conductor carrying 
the current to be measured is wound around 
the sensing core); it is a multiplication factor 
applied to the magnetic field measurement 
which magnetizes the core. The magnetic 
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Figure 2: Arrangement of the Hall sensors on the core section. 


flux density in the core B, (where , stands 
for Core) is the same as in the air gap B, 
(where , indicates Gap) so that B, = B,. This 
Is a consequence of Maxwell's equations. For 
simplicity we can assume that the magnetic 
fields are homogeneous in the core and the 
air gap. The material equation B, = Ho x Hy 
applies in the air gap region while in the core 
B, = H; X Ho X He Ferrite materials have a 
typical permeability value u, of around 2,000. 
From this Hg = p, X He, ie, in the core, the 
magnetic excitation is smaller by a factor of p, 
than in the air gap. In practice, therefore, we 
can often neglect the core excitation factor. 


Ampere's circuital law relates the integrated 
magnetic field around a closed loop to the 
current passing through the loop. The line 


integral of the magnetic H field around a 
closed curve equals the free current nl. In 
Figure 1 the curve is shown as C. The air gap 
here has the length /, = 7.6 mm and the length 
of one core-half is given by |, 2 rmxd,/ 2 
where the core diameter d, = 18 mm. Ampere's 
law indicates: 


2XlXHo t 2xl,.xH,— nl 


If we insert the value of H, and solve the 
equation for H, we get: 


H,-nl/(2xly* 2xl./ uj) 
This allows us to calculate the magnetic field 


detected by the sensors as a function of the 
current. In this project, two A 1324 LUA-T Hall 


VCC 5V 
Out- 
GND 


Figure 3: The Hall sensor connections. 


sensors with a sensitivity of S = 5 mV / G are 
used. This results in a voltage output from the 
sensors equal to: 


V-2xSxyoxnl/(2xly * 2xl./ uj) 
By plugging values into the equation we get: 
V—1x38.92mV/ A 


When we consider the levels of current 
typically encountered for average electronic 
applications this produces voltages in the 
millivolt region which are not too extreme. 
If we ignore the field in the ferrite we can 
simplify the expression to: 


V-Sxyuoxnl/l, 
which gives V = I x 39.26 mV / A, giving a 


simplified scaling factor close enough to the 
value derived above. 


A1324LUA 
VCC 


A1324LUA 
vec 
IC2 Out. 


GND 


Sensor2 


GND 


Out+ 
VCC 5V 


The Ferrite Core 

The core element of the DC amp-clamp 
consists of the two halves of a standard, 
hinged EMI-suppression ferrite that you often 
find clamped to cables exiting an enclosure 
containing electronic equipment (Figure 2). 
The two Hall sensors are glued to the end 
cross-section surfaces of one half of the 
core to form the air gaps. A small piece of 
1.6 mm thick pertinax or perf board (with any 
copper tracks removed) carries the sensor 
and defines the air gap. In Figure 3 you can 
see how the sensors are positioned. 


The two core halves can then clamped 
together using, for example, adhesive 
tape or a rubber ring. The current-carrying 
conductor can then be positioned through 
the centre hole in the ferrite core assembly. 
Figure 4 shows an example where a single 
core conductor has been looped several 
times around the core which has the effect 





Figure 4: Multiple turns around the core 
increases sensitivity. 


of linearly increasing the sensitivity of the Hall 
effect sensor. 


The Electronics 

An MCP3421 is used as the analog/digital 
converter. This device is a low-cost 18-bit 
converter. It has an internal voltage refer- 
ence of 2.048 V and uses a differential 
input stage. The quiescent voltage output 
level of the Hall sensor is half-rail. When 
they are positioned in the core air gaps as 
shown, the magnetic flux produced by the 
current flowing in the current-carrying cable 
produces a positive-going voltage change at 
the output of one sensor and a corresponding 
negative-going change in the other sensor 
output. Connected in this way, their output 
voltage swings are effectively added at the 
differential input stage of the A/D converter. 
The resolution of the 18-bit A/D converter is 
2.048 V / 2 = 0,015 mV, which is adequate 
for this application. 


Arduino 


Nano 


5V 


VDD 
In* 
MCP3421 
IC3 


Vin 128x64 OLED 
SSD1306 


SCL AS,SCL D11,MOSI 
SDA A4,SDA D13,SCK 


GND 





Figure 5: The complete circuit of the Amp-clamp meter. 
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An Arduino Nano microcontroller is used 
as the CPU; it has more than enough GPIO 
options for our design. A low-cost 128 x 64 
pixel OLED display serves as the display. 
Altogether the relatively simple circuit can 
be seen in Figure 5. If you would prefer to 
use an analog indicator, you can also connect 
a moving-coil voltmeter at the output. One 
volt output then corresponds to one ampere 
sense current. 


The Commands 

To operate and to set the scaling parame- 
ters used in the author's software, a few 
commands can be entered via the serial inter- 
face of the Arduino IDE. The measured values 
are also displayed via the serial interface. 


Command ‘0’ = zero adjust 

This command should only be issued when 
there is no measurement current flowing 
through the clamp meter sensing core. The 
software carries out a zero adjustment and 
stores the value of this offset in non-volatile 
EEPROM. The Hall sensors have an offset 
voltage (which drifts with temperature) that 
needs to be compensated for in order to get 
accurate measurements. 


Command ‘T = Scale factor for 1A 

This calibration step is used to find the internal 
scale factor when a current level nl = 1A is 
flowing through the measured cable. The 
scaling factor is calculated and then stored 
to EEPROM. 


Command '5' = Scale factor for 500 mA 
Like Command ‘T but here the reference 
current is set to 0.5 A. 


Command 'u' 

When a value following 'u' is entered this value 
will be output and displayed as a voltage. The 
amp-clamp meter then enters 'DVM calibra- 
tion mode' for a period of time when you can 
use the ‘+’ and -' to calibrate the output to 
the target value. 


Command 'd' 
Default values of the parameters are written 
to EEPROM to initialize it for its first start. 


Construction 

To demonstrate the basic principle, | built the 
prototype using a prototyping plug board and 
flying lead wire jumpers to connect the various 
components used in the circuit (Figure 6). In 
the foreground, you can see the ferrite core 
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Figure 6: The prototype layout using plug board. 


with the small display on the left and the 
Arduino Nano on the right. The software was 
developed using the Arduino IDE and then 
downloaded to the Nano board. The latest 
version of this software is available free of 
charge from the Elektor web page for this 
article [1]. The prototype Amp-clamp project 
was tested and behaved as expected when it 
was fired up. We hope this circuit will inspire 
you to carry out your own experiments or 
build other projects relating to the magnetic 
measurement of currents! I< 

200595-01 


— WEB LINK 


Questions or Comments? 

If you have any questions or comments 
regarding this article, please let us 
know. Contact us at 
editor@elektor.com! 


Contributors 

Project and Text: 

Prof. Dr. Martin Of$mann 
Editor: Dr. Thomas Scherer 
Translation: Martin Cooke 
Layout: Giel Dols 





[1] Article web page: www.elektormagazine.com/200595-01 
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PROJECT INFO The first, very important design criterion 

was to keep the total costs as low as possi- 
Tags ble. Nothing fancy, just a well-functioning, 
Tools, lab, soldering, Weller, Hakko, JBC sturdy design. And it may look a bit old-fash- 
Level ioned in the SMD-age, but when it comes to 
entry level - intermediate level - expert level soldering hardware, most makers still prefer 
Time through-hole parts. Although it gets increas- 
About 4 hours ingly difficult to find through-hole electronic 
Tools components (especially integrated circuits), 


Soldering tools, mechanical tools, 


3D printer (optional) 
Price 


€70/£60/$80 approx. 
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we wanted to present a complete TH-design 
to make this new project easy to build. To 
simplify building and wiring this solder- 
ing station, it consists of two PCBs (a main 
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g Station 


By Luc Lemmens and Mathias Claufen (Elektor) 


Although there are ready-made solder 
stations for sale in abundance, there 
are still people who prefer to build 

this equipment themselves. The DIY 
solder station for Weller RT irons we 
presented in our October 2018 issue [1] 
proved to be very popular among our 
readers. With the feedback we received 
on this project, we decided to make a 
new design for Weller RT, with support 
for Hakko FX-8801 and JBC T245 
soldering irons too. 


board and a frontpanel board) that are inter- 
connected with one flat cable only. A new 
Microchip Technology AVR microcontrol- 
ler is used here, enabling us to design the 
software for the Arduino IDE, offering this easy 
development platform to readers who want 
to change the software. 


We were rather proud of and pleased 
with the compact design of the previous 
solder station, with an external, standard 
12 VDC power supply. However, many of 
our readers complained that it was way too 
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Figure 1: Schematic diagram of the main board. 


small and not heavy enough to stay put on 
the workbench during soldering. And we 
have to admit: it may be great for porta- 
ble applications, but it is far from ideal for 
a desktop solder station. Integrating the 
power supply into the new design is an 
easy way to solve this issue, and above 
all, a 60 VA toroidal transformer will do a 
fine job to put some more weight into the 
enclosure. A larger LED display improves 
the readability of the temperature setting, 
as compared to the smaller OLED display of 
the older station. It shows less information, 


PATISS 


but the most important value (the tempera- 
ture) can now be seen with a quick glance. 


Never change... 

From a hardware point of view, the previous 
design was working fine, and we didn't really 
change much in that respect (see Figure 1). 
The temperature measurement and control 
circuitry are quite similar for that matter. 
However, during the prototyping phase we 
already had some doubts on the use and 
necessity of the current measurement with the 
shunt resistor and INA138 sense amplifier. It 
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made the hardware and software to control 
the temperature unnecessarily complicated, 
so we completely left this part of the circuit out. 


Power supply 

The new solder station is powered by one big 
toroidal transformer (2 x 12 V, 60 VA), with the 
two secondary windings connected to K1 and 
K2, respectively. The type that is prescribed in 
the BOM has also two primary windings, allow- 
ing both 115 VAC (primary windings in paral- 
lel) and 230 VAC (windings in series) mains 
voltage. Of course, you can also buy a trans- 
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TM1637 





Figure 2: Front panel board schematics. 


former with the same specs on the secondary 
side, but the primary side matching your mains 
voltage only. One of both secondary windings 
is used for the +5 V supply of the logic and 
control circuits, via diode bridge B2 and DC/ 
DC converter IC1. Depending on the type of the 
solder iron to be used, the secondary windings 
can be switched either in parallel or series by 
REI, the lower voltage being selected when 
the relay is switched off, the microcontroller 
can control the relay via transistor T1. The AC 
voltage is rectified and smoothed (B1 and C1), 
and is measured via voltage divider R3 and R6, 
which scales it to the input range of the inter- 
nal ADC of the microcontroller. Zener diode 
D2 serves as overvoltage protection. 


The power delivered to the solder iron — and 
thus the temperature of the tip — is PWM 
controlled, using the same circuitry (T2 to T5) 
as we used in the DIY solder station (180348- 
1). Common mode choke L2 suppresses 
RF-interference on the cable of the solder iron. 


Measuring temperature 

The operational amplifier circuits around IC2A 
and IC2B amplify the voltage on the tempera- 
ture sensor terminal 361 times (C-Type for 
Hakko) and 181 times (K-Type for Weller and 
JBC), respectively. We preferred two separate 
fixed amplifiers to switching the resistors to 
adjust the amplification. The type of the solder- 
ing iron is set in software and the microcontrol- 
ler will select the corresponding supply voltage 
and ADC-input to measure the temperature of 
the tip. A DS18B20 1-Wire temperature sensor 
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can be connected to K7 to measure ambient 
temperature for cold-junction-compensation 
of the thermocouple inside the soldering iron. 


Programming and debugging 
Fortunately, microcontroller manufacturers 
like Microchip/Atmel understand and know 
that there is still a market for through-hole 
components, so even the recent ATmega4809 
with Microchip's ‘new’ Unified Program and 
Debug Interface (UPDI) programming inter- 
face is available in a 40-pin DIP version, ideal 
for prototyping and DIY-projects. K11 provides 
a UPDI for this microcontroller that — as the 
name already suggests — is used for both 
programming and debugging. More details 
on this successor of the AVRISP (that has 
served us for so many years!) can be found 
on Elektor Labs [2]. This page also shows 
how to implement an Arduino Uno board as 
a programming interface that can be used 
for this project. Please note that the quite 
affordable Microchip Snap UPDI program- 
ming/debugging interface is not supported 
in the Arduino IDE (yet!). 


Boxheader K12 is the connection to the front 
panel (display and rotary encoder) board, 
that will be discussed later. The pin labeled 
‘spare’ is not used in the current version of 
the hard- and software but may be used for 
an extra input or output on the front panel in 
later developments. 


Almost all unused pins of the microcontrol- 
ler are routed to SIL-connectors on the PCB. 


Two UARTS can be found on K6 and K10 
respectively and other (analog and digital) 
I/Os on K4, K5 and K9, but none of these has 
a dedicated function or is supported in the 
current version of the firmware. 


Front panel PCB 190409-2 
Looking for affordable displays, we came 
across a lot of ready-made 4-digit I2C 
controlled modules, many of them controlled 
by a TM1637 LED display driver produced by 
Titan Micro Microelectronics. These displays 
are widely used in the makers community 
and can be used in our solder station too. 
For a solder station three digits would have 
been enough for displaying temperature, but 
the four-digit ones proved to be the more 
affordable option. Since we also have a rotary 
encoder with pushbutton on the front panel 
and wanted to keep the wiring between main 
and front PCB as simple and tidy as possible, 
we decided to make our own circuit board 
with all these components on it and only one 
flatcable to connect our two PCBs. For that 
reason, we made our own design using the 
TM1637 and a quadruple 7-segment LED 
display, see Figure 2. The TM1637 Is avail- 
able in both DIP and SOIC and although we 
wanted to keep the complete design of the 
solder station through-hole-parts-only, we 
made an exception for this integrated circuit 
by providing footprints for both package 
versions on the PCB. The main reason for this 
was that shipment of the DIP ICs we ordered 
in Asia was delayed due to COVID-19 and we 
had some complete modules lying around 
in the lab. Scavenging an SOIC from one of 
these boards was the fastest way to continue 
developing our prototype. 


Software 

The code itself consists of several parts that 
interlock. These are implemented as classes 
and objects created from them. Whoever works 
with the Arduino framework uses objects and 
classes, often without knowing it. Roughly 
formulated a class represents a construction 
plan with which a suitable object is created 
in the code, i.e. what is created when build- 
ing according to the construction plan. An 
introduction to the object orientation of C++ 
is something that lies far beyond the scope 
of this article; therefore, we will discuss the 
objects and classes in a very abstract way here. 


Let's take for example the display, called 
frontend in the software. It serves to visualize 
the values (e.g., temperature, menu and error 
codes) that are transferred from the core of the 


station to the frontend. Now it wouldn't make 
much sense to make the necessary adjust- 
ments in the code for each display with differ- 
ent display characteristics (OLED, Character 
LCD or 7-segmernt display). 


This is where the classes and objects come 
into play: for the core of the software the 
frontend is always a display, which always 
provides the same functions. So with the 
appropriate classes (construction plans) the 
software for a soldering station can be built 
for the hardware described here. If you prefer 
to use (for instance) a 0.96" OLED instead of 
the LED display, only the code for this frontend 
must be integrated. 


The code of the DIY Soldering Station 
(180349) was designed to make this possi- 
ble. The core of the station remains basically 
the same, only the parts around it are adapted 
to the hardware. 


Adjustments were also made for temperature 
tracking. As shown in the circuit diagram, 
two separate operational amplifiers are 
installed, one for Type-K and one for Type-C 
thermocouples, so that tips and handpieces 
from different manufacturers can be used. 
Additionally, a cold-junction-compensation 
based on a DS18B20 is provided; a suitable 
sensor is automatically detected and evalu- 
ated. Depending on the soldering tip that is 
configured in the settings of the solder station, 
the analog input AO or A1 is automatically 
selected and converted to the corresponding 
temperature. Then, if available, cold junction 
compensation is applied. The temperature 
at this point comes from a OneWire sensor 
DS18B20 where a few tricks had to be used 
for the readout. After starting the software, the 
system searches for this OneWire sensor, if 
none is found, it is noted in the software and 
no further attempt is made to search for the 
sensor again. If there is a sensor and it is found, 
the readout of the temperature is divided into 
two steps. The first step is carried out every 
two seconds and starts the recording of the 
current temperature. The sensor now needs 
at least 750 ms conversion time until the 
value is ready to be read and processed. 
Since the MCU should not stop 750 ms, the 
start of conversion is flagged. If this start of 
the conversion is more than one second ago, 
the value is fetched from the sensor and it 
is noted that the readout was completed. 
After one second the next read sequence 
is started. This way the core can perform 
other tasks during temperature conversion. 
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Figure 3a: Layout of the main board. 
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Figure 3b: Layout of the frontpanel, 


PWM with Timer A 

The timers in ATmega4809 are a bit differ- 
ent from the ones in its predecessors. In this 
new microcontroller Timer A can provide 
six PWM outputs, which is very practical 
for driving servos, LEDs and other compo- 
nents. This is also the standard configuration 
of MegaCoreX, the hardware package that 
needs to be installed in the Arduino IDE for 
the ATmega4809. Timer A is a 16-bit timer 
with three PWM outputs, but is by default 
configured as an 8-bit timer with six outputs. 
This is sufficient for servos, but for the power 
control of the soldering station it is not enough 
to control the power at 10 kHz. Therefore, the 
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Timer A has to be switched back to 16-bit 
mode for PWM generation in our solder 
station. 


Rotary encoder and push button 

The rotary encoder is processed with a timer 
interrupt routine. Every 250 us the pins of the 
rotary encoder are read, and the direction 
of rotation is determined from the last four 
states of the pins. Since the rotary encoder 
has mechanical contacts, rotation would not 
produce clean edges on the input pins of the 
ATmega and there would always be some 
noise in the signals without any filtering. Three 
RC Low-pass filters and software-filtering are 
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em» 
COMPONENT LISTS 
MAIN BOARD 


Resistor 

R1,R11,R12 = 18 k 

R2=1M 

Ro = 68 k 

R4,R5,R13,R14 = 5.6 k 
R6,RZR19 = 10 k 

R8,R15,R18 = 100 Q 

R9=10M 
R10,R16,R17,R20,R21,R22 = 4.7 k 


Inductor 

L1 = Choke 10 uH, 130mA 

L2 = Common mode choke 10A, 
Laird CM2545x171B-10 


Capacitor 
C1 = 4700 uF, 50 V, 10 mm pitch, 22x41 mm 
920501005 509 29) gf) EC [3/5 XT RTI 
C3SoSCOCILCIA = 100 ne 50M X7R, 

5.08 mm pitch 
C4 = 100 uF, 50 V, 3.5 mm pitch, 8x11 mm 
CoC7Ci27 Cla —0mlg 50V 5mm ee o XTR 


Semiconductor 

D1 = 1N4007 1000 V, 1A 

D2 = Zener Single Diode, 51 V, 500 mW 

D3 = 1N4148, 100 V, 200 mA, 4 ns 

B1,B2 = Bridge rectifier D6KB6U, 600V, 6A 

TAT2, T4 = BC547C, 45 V, 100 mA, 500 mW, 
hfe=400 


used to suppress the noise. The pushbutton of 
the rotary encoder is processed in the same 
function and thus also checked every 250 us. 


Errors... 

Every 50 ms the actual temperature of the 
soldering iron is compared to the set value. 
If the station detects a temperature higher 
than 650?C, this will be interpreted as a 
sensor defect and heating will be switched 
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T3 = IRE9Z34NPBE MOSHE IP 55V, 7A, 
100mOhm 

T5 = BC557C, -45 V, -100 mA, 500 mW, 
hfe-400 

IC1 = DC/DC converter 
OKI-78SR-5/1.5-W36-C, 5V, 1.5A 

IC2 = Dual OPAMP MCP6002-E/P 

IC3 = 8-bit MCU ATmega4809-PF 


Other 

RE1 = Power Relay, 5 VDC, DPDT, 8A, 
Schrack RT424005 

K1,K2,K3,K8 = Terminal block 5.08 mm, 2-way, 
630 V 

K4,K7,K10 = Pin header, breakable, 1 row, 
3-way, vertical 

K5 = Pin header, breakable, 1 row, 
2-way, vertical 

K6 = Pin header, breakable, 1 row, 
4-way, vertical 

K9 = Pin header, breakable, 1 row, 
5-way, vertical 

K11 = Pin header, breakable, 2 rows, 
6-way, vertical 

K12 = 10-way boxheader, pitch 2.54mm 


Misc. 

Toroidal mains transformer 60VA, 2x115V, 2x12V, 
MCTA060/12 

primary fuse 20mm 630mA @240VAC 

primary fuse 20mm 1.25A @115VAC 


off to prevent overheating. If the station does 
not detect a temperature increase at the tip 
after six seconds of heating up, this is also 
seen as an error and heating up is aborted. 
For a defect in the temperature sensor, the 
station shows E-01 on the display, for an error 
in heating E-03. By briefly pressing the knob of 
the rotary encoder, the error can be acknowl- 
edged, and the station will attempt to continue 
normal operation. 


K & B 59JR101-1FR-LR IEC connector 42R 
Series (mains connectors, Conrad 736709) 

10-way IDC Receptable (2 pcs) 

10-way flatcable, approx. 20 cm 

PCB 190409-1 V11 


FRONT PANEL 


Resistor 
R1, R2,R3 = 10 k 


Capacitor 

Cl= 100 UR 50V 35 mm pitch, ex T mm 
C2 = 100 nF, 50 V, X7R, 5.08 mm pitch 
C3,C4,C5 = 10 nr, 50V, 5mm pitch, X7R 


Semiconductor 

LD1 = Quadruple digit 7-segment LED display 
KW4-801AVB (Luckylight) 

IC1 = 12C LED drive control special circuit 
TM1637 


Other 

ENC1 = Encoder with pushbutton, 
Bourns PEC11R-4225F-N0024 

K1 = 10-way boxheader, pitch 2.54mm 

PCB 190409-2 V11 


Building the hardware 

The Gerber files of the two printed circuit 
boards (Figure 3) can be downloaded at [3], 
you can use these files to order the PCBs. 
Soldering boards with through-hole compo- 
nents will not be too difficult. Note that the 
front panel board has most components on 
the top side, with a double footprint for the 
display driver IC1 (SOIC and DIL) and that only 
one of both is to be used, of course. The LED 





[1] DIY Temperature Controlled Solder Station: www.elektormagazine.com/magazine/elektor-70/42342 


[2] UPDI programmer for ATmega4809 and ATtiny816/817: 
www.elektormagazine.com/labs/arduino-for-updi-programming-for-atmega4809-and-tiny816817-with-jtag2updi 


[3] This project's downloads: www.elektormagazine.com/190409-01 
[4] Enclosure STEP files: https://github.com/DK1CMB/Elektor-SolderironCase 


[5] Knob STEP files: www.thingiverse.com/tracert/designs 
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display and rotary encoder must be soldered 
on the bottom side of the PCB. 


Last time we provided for our small solder- 
ing station a working PCB without an 
enclosure. This also made a few readers 
stumble to get the electronics inside one. 
This time the DIY is extended not stopping 
at the PCB and wiring, but also now comes 
with a 3D-printable enclosure that was 
kindly constructed externally by Caroline 
ClauBen. All STEP files can be downloaded 
at [4] and printed on the most common 
3D-printers like the Anycubic I3 Mega-S 
(pls see "Related Products"). One word of 
warning, though: some parts take a long time 
to print, but never leave a running 3D-printer 
unattended, as these machines operate with 
high currents, they may catch fire. 


If you ever wondered why PCB CAD tools like 
KiCad and Altium can present 3D models for 
the components: it makes designing an enclo- 
sure a lot easier. From this PCB design tools 
you can export your creation as 3D STEP file 
and use it with every tool that can handle this 
file format. Almost any 3D design software 
can then be used to construct a nice-looking 
case around the 3D model of the PCB. Here, it 
resulted in nine parts that need to be printed. 
In total it will take up to 24 hours print time, 
depending on your printer the time can vary. 
If all parts have been printed the final step 
will be assembly and a few, non-3D-printable 
parts are required. First, an IEC power entry 
with integrated power switch and fuse holder 
is needed, with bolts and nuts to fix it in the 
back panel, as shown in Figure 4. Some wires 
and spade connectors are needed to wire the 
switch and fuse to the primary windings of 
the transformer. When connecting the trans- 
former, please note that the terminals at K1 
and K2 are marked with the first characters of 
the secondary winding wire isolation colours 
(Black, Red, Orange and Yellow respectively). 
If you use a different brand or type of trans- 
former, make sure that the ‘start-of-wind- 
ing’ marks of the wires, normally depicted 
with dots in the datasheet, match with the 
Multicomp transformer we used. And of 
course: remember to install the fuse on the 
primary (mains) side of the transformer. 


To screw the front back and cover together 
you can use M2.5 screws. For the PCB you 
get four pillars, that should be put into the 
base and afterwards you put the PCB on top 
and insert the screws, as this will compen- 
sate for inaccuracy your 3D printer may 





Figure 4: Power entry with fuse holder and power switch. 


have. With a bit of patience, you will end up 
with a construction that looks like the one 
in Figure 5. 


Note: This soldering station has been 
thoroughly tested with a Weller RT handpiece. 
Unfortunately, we didn't have a Hakko FX-8801 


or JBC T245 soldering iron available for 
testing, but it should be working okay with 
these brands/models too. 


The connection for the soldering iron 
(Figure 6) can be done in various ways. There 
Is no ready-made hole in the enclosure for 





Figure 5: Inside the 3D-printed enclosure. 
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this. For our prototype with the Weller RT 
soldering iron we mounted a 3.5 mm audio 
jack connector, which is not the best possible 
solution, but it does work. Do not use a flexible 
audio extension cable, the cross section of the 
copper wire is too small to handle the current 
for the heating element. We have tried this 
and instead of heating up the iron we had a 
more than hand-warm cable within a minute. 
We solved this by a cable with a bigger cross 
section. Last but not least: the knob. As every- 
one has their own preferences of knobs, size 
and shapes you can simply search for "rotary 
knob" at Thingiverse and choose the one 
you like most. We here used as example the 
design by Domain Mittu [5]. For the knob we 
used TPU filament, this is softer and will give 
you a nice grip. We printed the red cover with 
PTEG filament, something that is not that easy 
to handle but stronger than PLA. It is perfectly 
fine to print the cover with PLA. 


Operation 

At first power-up, before a soldering iron is 
connected, keep the pushbutton of the rotary 
encoder depressed while switching on. This 
opens the boot menu for selecting the type 
of soldering iron, enabling to choose from CO 
to C2, corresponding to Hakko FX-8801, JBC 
1245 and Weller RT respectively. Press the 
rotary encoder for ten seconds to store this 
selection and the station will reboot with the 
correct voltage (12 V/24 V) and analog input 
for the temperature measurement. Of course, 
this selection is stored and preserved after 
switching off. During normal operation, the 
rotary encoder is used to adjust the tempera- 
ture of the soldering iron. The display will light 
at maximum brightness when this setting is 
being changed. The new temperature setting 
will be applied five seconds after the dial is 
released. The display then dims to normal 
brightness and shows the actual tempera- 
ture of the tip. When the soldering iron is 
heating up, the leftmost decimal point of the 
display blinks. 


We are sure that with this new soldering station 
most of the objections to the earlier design 
have been resolved, but of course there is still 
room for improvement. In order to be able to 
easily expand the hardware, we have routed 
almost all of the unused microcontroller pins 
to expansion connectors on the main board. 
Should you make adjustments or extensions 
yourself that may be of interest to other readers, 
please share them with us! K 

190409-01 
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Figure 6: Connecting the Weller RT. 


Questions or comments? 

Do you have questions or comments about his article? Email the authors at 
mathias.claussen@elektor.com and luc.lemmens@elektor.com or contact Elektor at 
editor@elektor.com. 
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Hands On the 


Parallax Propeller 2 


Part 2: The Develooment Environment and Code 


By Mathias Clauf3en (Elektor) 


In Part 1 of this article series, I introduced the Propeller 2, Parallax s new advanced multicore 
microcontroller. Now let's dive into how to use the Spin2 language to light up an LED. 


Now that you are familiar with Parallax's Propeller 2 and its features, | 
want to cover the development environment and coding. Read on to 
learn how to drive an LED. 
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Figure 1: Propeller Tool user interface. 
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Figure 2: Access to the Spin2 documentation through the Help menu. 


Access the onboard LEDs 

Let's get started with the software environment and controlling one of 
the on-board LEDs. We will do our development in Windows 10 with 
the vendor-provided tools. At the end, a basic software setup will be 
in place to compile and upload code to the Propeller 2. 


Parallax provided its Propeller Tool Version 2.3 Alpha including 
Propeller 2 support for Spin/Spin2. If assembly language is preferred, 
you can use PNut as development environment or do inline assembly. 
If you like to code in C/C++ like me, the compiler and development 
environments are currently not ready for prime time. There are efforts 
going on to improve the C/C++ compiler situation and those can be 
seen at the video presentation [1] about C / C++ on the Propeller 2. 


Basic development environment 

You can download the Propeller Tool 2.3 Alpha at [2]. Download the 
Propeller Tool 1.3.2 first and add to its program directory the Propeller 
Tool 2.3 Alpha executable as a second step. After the installation is 
done, you can start the editor and begin coding. The user interface 
for the tool is shown in Figure 1. 


Assembler or Spin2 for coding? 

The question will be: Spin2 or Assembler for the initial code? To keep 
it simple, we will, for now, continue with Spin2. Spin2 is an interpreted 
language, like BASIC, but different. The commands and language 
references to Spin2 can be found using the Propeller Tool under the 
Help menu entry (see Figure 2). 


To get started with Spin2, you can use a currently preliminary manual, 
but keep in mind that it is not finished yet. This will lead to the 
current documentation for the implemented Spin2 language on the 
Propeller 2 MCU. 


As this is interpreted code in the end, you will need approximately six 
instruction cycles, meaning 12 clock cycles, to execute one command. 
This isn't the fastest way, in terms of clock cycles, to get things done, 
but Spin2 give an easier stating point than starting with assembler. 
As Spin2 has a more high-level approach most commands hide a 
lot of the assembler instuctions and are more natural to use than the 
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Figure 3: Creating a new Spin2 project. 
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Figure 4: Close look at the LEDs attached at MCU pin 56 to 63. 
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Figure 5: Schematic for the LED driving 74HCT244 buffer. 
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assembly instructions. You can create a new Spin2 project like what 
you can see in Figure 3. 


I/O Pins 

Before we continue with writing code, let's briefly look at how the 
I/O pins work. We use them here as ordinary I/O pins and will offer 
an in-depth overview later about all their capabilities. Generally, we 
need to set the pin of choice as an output to drive a low or high level. 
On the evaluation board, you can clearly see the LEDs marked with 
P56 up to P63 (see Figure 4). This is a group of LEDs connected to 
the pin 56 up to pin 63 on the Propeller 2, so we will choose the first 
LED56 to light it up. If you look at the schematic, it is clear that they 
are not connected directly to the chip but attached to a 74HCT244 
octal buffer. Also notice that the LEDs are connected with their anode 
permanent to VCC and the I/O pin, with the buffers help will tie the 
cathode to ground to make them light up (see Figure 5). 


Inverted LED 

For the code we are going to write, this means that a driven high 
level at the MCU pin will turn off the LED and low level will let it light 
up. With this inverted logic in mind, we need to let our code drive the 
LED pin 56 a high state to turn it off. If we don't do anything, the pins 
will be by default be an input and the octal buffer will act like the pin 
is driven logic high, so turning every LED connected to it off. For our 
Spin2 code, to light up the LED, this means we need to: 


> Initialize the MCU and at least one core (cog) 
> Set the pin 56 as output 

> Drive pin 56 low 

> Do nothing 


Step one, the initialisation, in this case, is done for us and we don't need 
to care for this example about it. The Spin2 code itself just needs some 
lines of code. Our code begins with the function pub main() followed 
by the pinwrite() method (see Figure 6). The pinwrite() is built 
into the Spin2 language and allows one or more pins to be set with 
a given value. Here we just use pin 56, which our LED is connected 
to, and pass for the output level a '0' to turn the pin low and the LED 
on. The last line repeat will force the cog into an endless loop, as 
the code below the repeat will be executed. In this case, there is no 
more code forcing the cog to do nothing but keep it running. If we 
don't use the repeat here, the cog will reach the code's end and stop 
driving the I/O pins. 


Moving code into the Propeller 2 

If the code is ready, you can upload it to the Propeller 2 evaluation 
board and let the code execute. For this to happen, you just attach 
the board to one of the system's USB ports and select from the menu 
Run-»Compile Current-» Load RAM to upload the code directly into 
the MCU RAM and let it execute. As the LED on pin 56 now lights up, 
you are done with the first kind of "Hello, world.” One question that 
may arise: "Can you make it blink?" Yes, this can be done. In Spin2, 
we have a WAITMS instruction that e.g. with WAITMS (500) will delay 
the execution of code for 500 ms. As we have learned that the code 
after REPEAT is executed over and over, the next step will be to make 
the LED blink. A little exercise will be to try to modify the code in a 
way that the LED will blink. Use the information you have gathered 
so far to develop and modify the code to get a blinking LED. For this 
exercise, we will give a sample solution later on. 


@ Propeller Tool - P2: LED On 
File Edit Run Help 


Ə LED On P2: LED On* | 
(© Full Source {© Condensed — (^ Summary — (^ Documentation x| 
pinwrite (56, 0 ) 






| | ~] repeat 
Je Windows (C:] 
"am Data (D:] v 





[all Propeller Source [*.spin/spin2] -] 


1:9 [Modified | Insert - ! Compilec PUB main - 8 bytes l 





Figure 6: Resulting code to light up LED 56. 
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As we can now drive an I/O pin, the next step is to figure out how to 
send serial data. Most of us are used to this debug style, especially 
as first or second steps on a device like an AVR. As this will involve 
the Smart-Pin functions, the next step will be to get familiar with 
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Do you have questions or comments about his article? Email 
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Wi-E1 for LoRa Switch 


Integrated in Home Assistant with ESPHome 


By Clemens Valens (Elektor) 


The Elektor LoRa Switch [1] has a nice 


relay board that can easily be used 


in Wi-Fi networks if the LoRa 


module is replaced by Wi-Fi. It 


then becomes the Elektor 
Wi-Fi Switch. 


In the March-April 2020 edition of Elektor 
magazine, a remote-controlled switch was 
published [1]. It had state feedback and 
communicated using LoRa. Because it was 
housed in a waterproof IP66 enclosure, it 
was suitable for outdoor use. It was also a 
modular project with the relay and power 
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AU 


circuitry on one board and the LoRa commu- 
nication part on another. 


This interested me, because | was looking 
for an outdoor switch that could be 
integrated easily into my home automa- 
tion system. This system is based on Home 







Assistant and Wi-Fi, but not LoRa. | am sure 
it is possible to add LoRa to it, but | didn't 
want to dive into that. Instead, | thought 
that by simply replacing the LoRa module 
with a Wi-Fi module, | could make it run 
ESPHome, which works great with Home 
Assistant (Figure 1). 


Defining the Interface 

The first thing to do when trying to adapt 
something is finding out how to connect to. 
The schematic of the switch board is not 
very complicated (Figure 2). At the top, we 
have the power supply based on an AC/DC 
converter MOD! that provides 5 V with some 
protection and filtering things. 


In the center there is a bi-stable relay, RET, 
which switches the load on and off. A bi-sta- 
ble relay is much like a mechanical switch 
in that it keeps its state even after its power 
is switched off, exactly like a mechanical 
switch. It has two control signals to toggle its 
state: Set and Reset. These are driven by two 
MOSFETs T1 and T2 and active-high control 
signals are required. 


Note that the relay is protected by 5 A fuse 
F2 even though the relay can switch up to 
16 A. The reason for this is that the PCB traces 
cannot handle that much current, so the fuse 
protects them against melting. The switch 
board can handle loads up to about 1 kW. 


In the lower left corner, we find an optocou- 
pler IC1 that is in parallel with the load. When 
the load is switched on, the optocoupler is 








Figure 2: The switch board of the Elektor Lora Node (March-April 2020, [1]) has a bi-stabe relay at its heart. 


ESP-01 
Wi-Fi module 
ESPHome 


Home Assistant 





Switch board 


Wi-Fi/Switch interface 


Figure 1: System overview. In this article, we are mainly concerned with the mint green block. 


switched on too. Its LED makes its transistor 
conduct and the output goes low. When the 
load is switched off, the output of the optocou- 
pler is high. C4 together with RA filter out 
the 50 or 60 Hz AC signal, ensuring a nice, 
steady level. 


The connector in the lower right corner 
makes all the required signals available. S1 
is intended for a push button mounted on 
the device so that the switch can also be 
controlled locally. 


A detail to be aware of is that the optocoupler 
is connected to a 3.3 V supply, but there is no 
3.3 V supply on the board. This voltage has 
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to be provided by control board. 


The ESP-01 Wi-Fi Module 

We can now write down the specifications 
for the Wi-Fi control board that must drive 
the switch board: 


> It needs two digital inputs, one to read 
the optocoupler's output and one for S1; 

> It needs two digital outputs to control T1 
and T2; 

> It must provide 3.3 V for the optocoupler. 


Now, when you say "four digital I/O ports 


and Wi-Fi and 3.3 V’, you immediately think 
of the ESP-01 module, of course, as it has 
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Figure 3: The small and cheap ESP-01 module is equipped with an ESP8266EX microctroller with 
Wi-Fi support built-in. It has four I/O ports (GPIO 0, GPIO 2, RX & TX) and needs a 3.3 V power 


supply (VCC). 





Figure 4: A possible way to connect an ESP-01 module to the LoRa Switch board. The MOSFET 


decouple the inputs from the outputs. 
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I SD ED etes 
T112 = BSS84 


Miscellaneous 

K1 = 8-pin pinheader, 01“ pitch 

K2 = 2x4-way pinheader socket, 01" pitch 
K3 = 3-pin pinheader, 01" pitch 

PCB 200054-1 
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exactly four GPIO ports and Wi-Fi and it runs 
from 3.3 V. This popular module based on 
the ESP8266EX is cheap and easy to find 
(Figure 3). 


There is a but, however. The four GPIO ports of 
the ESP-01 must be handled with care, because 
they also determine how the module will work 
after power-on. For normal operation GPIOO, 
GPIO1 and GPIO2 must be high at power-on. 
This is mentioned in the notes below the 
'Pin Definitions' table in the datasheet of the 
ESP8266EX. Many ESP8266 users are aware 
of the requirements for GPIOO and GPIO2, but 
not everybody knows of the one for GPIO1, 
better known as TXD, the serial output. 


Matching GPIO Ports to Control 
Signals 

On the switch board, two of the four control 
signals are always low at power-up, 'Set' and 
‘Reset, due to resistors R7 and R8. When the 
load happens to be on at the moment the 
switch board is powering up, the 'On' signal 
is low too. Remember that this is possible 
because the relay is bi-stable and keeps its 
last state, even when it is not powered. 


Input S1 is floating. Its state at power-up is 
determined by the Wi-Fi control board unless 
someone happens to press the push button 
when the system powers up... 


So, all in all, we are dealing with four signals 
that can all be low at power-up. They must be 
connected to four ports, three of which must 
be high at power-up. Using an ESP-01 module 
in this situation therefore is a challenge. 


The Solution: Add Transistors 
The solution | came up with is as follows 
(Figure 4): 


> RXD (a.k.a. GPIO3) is the only pin 
that can be freely connected. | there- 
fore connected it to the output of 
the optocoupler because Its level at 
power-up Is unpredictable. RXD Is going 
to be an input. 

> When GPIOO is low at power-up, the 
module will boot in Flash programming 
mode. This can be useful for updating 
the firmware, so | connected it to S1. 
Therefore, GPIOO is going to be an input 
too. 

> GPIO2 and TXD (a.k.a. GPIO1) are now 
left over and therefore have to become 
the outputs. To decouple them from the 
low impedances created by R7 and R8 on 


the switch board, | inserted P-MOSFETs 
with a pull-up resistor on their gates. 
This ensures that at power-up GPIO2 
and TXD will see a high level. When the 
ESP-01 has finished booting, they can be 
configured as active-low outputs. 


The Output Driver 

The output driver is shown in Figure 5. When 
the GPIO signal goes low, the P-MOSFET 
BSS84 will conduct. This will pull the gate of 
the N-MOSFET BS170 high, so it will conduct 
too and the coil of the relay is powered. When 
the GPIO signal is high, the P- MOSFET BSS84 
will block. The N-MOSFET BS170 will now 
also block due to the 1 kQ pull-down resistor 
at its gate, and the relay coil is not powered. 
The 10 kQ resistor at the gate of the BSS84 
ensures that the GPIO pin is pulled high at 
power up. 


Loose Ends 


GPIOx 
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Figure 5: The output driver: a P-MOSFET drives 
an N-MOSFET. 


For the 3.3 V power supply, | simply added a 
low-dropout regulator to the 5 V supply line 
(Figure 6). In practice R1, R6 and LED! are not 
required as they are already included on the 
ESP-01 module, which is why they have 'NC' 
as value (i.e. not cabled). R5 is not needed 
either, but | added it just in case. Suitable 
values for R1 and R5 would be 10 kO, R6 could 
be something like 470 Q, 


| designed a little printed circuit board for 
the interface between the Wi-Fi module and 
the switch board (Figure 7). The files can be 
found at [3]. 


ESPHome YAML File 

With the in- and outputs defined, we can 
write the ESPHome configuration YAML file 
(see inset, available at [3]). This is a bit more 


YAML Configuration for the Wi-Fi Switch 


esphome: 
name: wifiswitch 
platform: ESPS266 
board: espO1. 1m 


WIFI. 
ssid: “my ssid? 
password: “my_passphrase” 


# Logging impossible as UARTO pins are 
# used for switches & sensors. 
logger: 

baud rate: © £ Hardware UART off. 


# Enable Home Assistant API 
api: 


# Enable Over-the-Air programming 
ota: 


output: 

= platform: gpio 
id: relay_set 
pin: GPIO1 # TXD, may not be pulled low at startup. 
inverted: true 

= platform: gpio 
id: relay_reset 
pin: GPIO2 # Do not pull low at startup. 
inverted: true 


switch: 
- platform: template 
name: “Wi-Fi switch” 
id: wifiswitch 
turn-on-actTon: 
# Pulse the Set pin. 
- output.turn on: relay set 
= delay: 0.1s 
—coltput.turm-offt: relay set 
trn orf ac Eilon: 
# Pulse the Reset pin. 
- output.turn_on: relay_reset 
- delay: 0.1s 
- output.turn off: relay reset 
# Use optocoupler state as switch state. 
lambda: return id(optocoupler).state; 


# Pushbutton & optocoupler. 
binary. sensor: 
- platform: gpio 
name: “Wi-Fi switch pushbutton” 
id: pushbutton 
pin: 
number: GPIOO # Do not pull low at startup. 
inverted: true 
on_press: 
then: 
=T: 
condition: 
binary_sensor.is_on: optocoupler 
then: 
switch.turn_off: wifiswitch 
else: 
switch.turn_on: wifiswitch 
- platform: gpio 
name: “Wi-Fi switch optocoupler” 
id: optocoupler 
pun: 
number: GPIO3 # RXD, may be pulled low at startup. 
inverted: true 
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Figure 6: A simple 5 V to 3.3 V adapter. The function of K3 is to provide 
some extra mechanical stability when the Wi-Fi module is plugged on the 


switch board connector. 


complicated than usual due to the bi-sta- 
ble relay that uses two pins instead of one. 
ESPHome and Home Assistant do know a 
so-called 'cover' component that can control 
such peripherals, but it is intended for garage 
doors and window blinds and the like that 
have an open and a close button. They also 
have a special icon. Our switch is just a switch 
and so we want it to behave like a switch and 
look like one. This can be done with a template 
switch that allows you to specify the behaviour 
for turning on and turning off separately. 


First, we define GPIO1, bettern known as TXD, 
as an inverted output named relay set. GPIO2 
Is declared as an inverted output named relay _ 
reset. We also define GPIO3 as an active-low 


Questions or Comments? 

Do you have questions or comments 
about this article? Email the author 

at clemens.valens@elektor.com or 
contact Elektor at editor@elektor.com. 
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binary sensor for the optocoupler output. 


Then we specify a short 100 ms pulse on the 
relay set output as a turn-on action and do 
the same on the relay reset output as turn-off 
action. As switch state we return the state of 
the optocoupler. 


To make push button S1 work as expected, 
meaning that pressing it will toggle the load 
on and off, we define GPIOO as an active-low 
binary sensor. When it is pressed, the state of 
the optocoupler is checked first. If the load is 
active, then we switch the relay off; if the load 
was inactive, then we switch it on. An if-then- 
else clause will do the trick here. 


RELATED PRODUCTS 











Figure 7: The interface between the EPS-01 Wi-Fi module and the switch 
board is mounted on a small PCB. 


Done 

After compiling ESPHome with this YAML file 

and flashing the ESP-01 module, the Wi-Fi 

Switch should pop up in Home Assistant 

and is ready for automation. Now it can be 

installed and "switch some load" M 
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[3] Project Files at Elektor Labs: www.elektormagazine.com/labs/wifi-switch 
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DEVELOPER'S ZONE 





Do Not Fear 





By Tam Hanna (Slovak Republic) 


the Cellular Module! 


Many consider designing a communications system based on a cellular wireless module a 
black art. This, however, could not be further from the truth. Tam Hanna recently had the 
pleasure of overseeing various such designs. Here is a compilation of his lab notes to help 


you with designing your own modules. 


Why Design Your Own Cellular Module? 

While ready-to-use 3G and 4G communication modules and USB 
dongles can be sourced easily from the Internet, the devil render- 
ing them unfit for your application and requiring a system redesign 
is usually hidden in the details. Some carriers and applications for 
instance use odd bands not supported by the module (US band 13 
being particularly troublesome), while for other systems the addition 
of a COTS USB dongle is unacceptable. And then there are applica- 
tions with requirements for uncommon antennas (think SMA) or that 
need GPS functionality too. 


Getting Started 

It all starts by finding a comms module that suits the communica- 
tion band(s) you selected and that fits the size and cost criteria. The 
quality of the field application engineering team of the comms module 
manufacturer, vendor or distributor is important too as you may need 
support at some point. The author found Quectel especially welcoming 
and helpful. Gemalto's distributor YAWID in Germany and Telit's Polish 
distributor were okay too. However, the author placed the popular 
Swiss manufacturer U-blox on the other end of the scale as he did 
not manage to get responses from them due to their e-mail system. 
But this is, of course, personal experience. It all depends on the region 
you're in, and you may have other experiences. 


The next step is to buy a development or evaluation kit for the comms 
module. Once you have it, force your software engineers to get the 
module's management software up and running for 100%, with empha- 
sis on 10096. Do not leave any open ends that may — and probably will, 
according to Murphy — invalidate your design later. Logic, furthermore, 
dictates that the vendor's field application engineering team should 
be your first contact for software problems that you may encounter. 
The degree of cooperation shown here can be used as a litmus test 
for hardware cooperation. 


Once the software is sorted out, it is time to obtain the comms module's 
documentation package, which is usually hidden behind an account 
login form on the vendor's website. Two documents are of particu- 
lar interest: the schematic of the evaluation board and the hardware 
design document describing the actual system. What you are looking 
for is the module's PCB footprint or landing pattern and a table listing 
the pins and their functions. 


Interface Ahoy! 

Most comms modules know but two ways of communicating with 
the host: a serial port and USB. Other interfaces like 12C and SPI are 
usually reserved for connecting peripherals and are of no interest for 
us here. This leaves us with USB and serial. Let's start with USB, the 
preferred interface for Linux-based host systems because of easier 
driver integration. The module usually appears as one or more TTY 
devices. Although USB 2.0 has been seen to work over a pair of Dupont 
breadboard wires, this does not mean that you can go crazy: do try 
to observe the basic rules of PCB layout, and keep the connector as 
close as possible to the module. However, do not fret about the exact 
impedance of the USB traces. 


The serial port is a different animal. While the author has yet to see 
a Linux-based system use the serial port for communication with a 
comms module, they frequently do get exposed on his boards. Module 
vendors usually designate one of its UARTs as a debug interface and 
if itis not exposed, a malfunctioning design cannot be analysed when 
sent to the vendor's lab. From this it follows that the serial port should 
at least be exposed in some way. The author often uses a connector 
positioned with minimal effort, and then leaves it unpopulated for 
series runs (Figure 1). 





Figure 1: The two unconnected pads on the left side are connected to the 
module's debug UART. The connector is populated on demand only. 


(Sektor May & June 2021 45 


Table 1. SIM Card (Smart Card) interface pinout is standardized. 


























(Source: pinoutguide.com [1]) 











Pin Name Description 
C1 VCC +5 VDC power supply input (optional use by the card) 
Reset signal, used to reset the card's communications. Either used itself 
(reset signal supplied from the interface device) or in combination with an 
C2 Reset , VM , i , 
internal reset control circuit (optional use by the card). If internal reset is 
implemented, the voltage supply on VCC is mandatory. 
Provides the card with a clock signal from which data communications 
C3 Clock MAN 
timing is derived. 
C4 Reserved | AUXI, optionally used for USB interfaces and other uses. 
C5 GND Ground (reference voltage) 
Programing voltage input (optional). This contact may be used to supply the 
voltage required to program or to erase the internal non-volatile memory. 
C6 V ISO/IEC 7816-3:1997 designated this as a programming voltage: an input 
PP for a higher voltage to program persistent memory (e.g, EEPROM). ISO/ 
IEC 7816-3:2006 designates it SPU, for either standard or proprietary use, as 
input and/or output. 
C7 I/O Input or Output for serial data (half-duplex) to the integrated circuit inside 
the card. 
C8 Reserved | AUX2, optionally used for USB interfaces and other uses. 


Sundry Parts 

Almost all comms modules are part of a family. Even though designs 
can be made to support multiple module types, this is not always in 
your best interest. Especially when working with low power units 
(think LTE M1, etc.), forgoing cross-family compatibility lets you use a 
smaller power supply, thereby saving costs. Also, in some cases reset 
circuitry and the like are not needed for all family members, which 
allows for an additional small cost saving. 


In case a well-defined reset pulse is needed, employ a microcontroller 
reset supervisor circuit such as the STM1001 from STMicroelectronics. 
These SOT23 parts do not cost much and are more reliable than a 
kludge made with RC elements. 


Regarding the power supply, not much needs to be said — the choice 
between a switching regulator or a linear one is mostly up to you. Do 
not, however, skimp on decoupling capacitors. 4G modules for instance 
are notoriously "bursty" in terms of power consumption. 





mL 


Figure 2: The trace the arrow points at can be cut easily and reconnected if 
needed. 
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Another thing to be aware of is "magic pins’ Carefully read the hardware 
description for each pin to make sure to understand what needs to 
be done. Some of them must be tied to a specific voltage level, while 
others, such as the boot mode selector pin, should be exposed by 
means of a pad or at least a via. If you are unsure, you can usually place 
a structure such as the one shown in Figure 2 to give you options after 
the prototype has been received. 


SIM Card 

Connecting the SIM card to the comms module is always an interesting 
challenge. SIM card holders usually have numbered contacts while the 
module uses labels (e.g, " Vcc  "Rst; "Data" and "CIk"). Fortunately, the 
contacts on the SIM card are standardized (see Table 1). Depending on 
the circuitry, a pull-up resistor between Data and Vcc may be needed. 
Sometimes decoupling capacitors are used on Rst, Clk and Data. The 
author usually omits the ESD protection diodes, as the SIM card holder 
will never be accessed by the user on his design. 


Some comms modules place an additional trap here. The presence 
of a SIM card can be detected by a voltage level on a particular pin. If 
you do not use this functionality, make sure to tie the pin to the voltage 
level that corresponds to "SIM card present” If you do plan to use it, pay 
attention to how it is implemented on your physical SIM card holder. 


Also, make sure to take mechanical clearances into account. Some SIM 
card holders flip open, while others require you to slide the (inflexible) 
SIM card in from a specific direction. 


Finally, let us disabuse you of the thought that comms modules must be 
mounted on four-layer printed circuit boards. All modern PCB design 
tools allow you to pour copper planes. A ground plane on both sides of 
the board stitched together with lots of vias usually gets the job done too. 


Antenna Matters 
The antenna remains. So far, the author has managed to avoid respon- 


R1 


Cl C2 


l l 


Figure 3: A pi network is required if antenna matching is planned. It can be 
bypassed in production by setting R1 to 0 Q and not mounting C1 and C2. 
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sibility for PCB antenna design and evaluation. (The HP 8753C vector 
network analyser he once bought at a customer's request has since 
turned out to be a first-class "hangar queen’, requiring both mainte- 
nance and expensive calibration kits, etc.). Without a PCB antenna, 
connecting an antenna to the board then requires a connector. Be it an 
SMA or U.FL type, always make sure to consult your enclosure designer. 


Strive to keep the connection to the antenna connector as short as 
physically possible. Furthermore, use a transmission line calculator (avail- 
able online) and try to somewhat match the recommended geometry 
(i.e, good ground on both sides and no vias in the signal path). Though 
usually there are no serious issues as long as the traces are kept short. 


Most vendor reference designs recommend placing a pi circuit similar 
to the one shown in Figure 3, just in case. In production it often gets 
neutralized with a 0 Q resistor while the two capacitors are not mounted. 
If you did not plan to do advanced antenna matching, better results 
can be obtained in many cases by reducing the distance between the 
comms module and the antenna connector and omitting the pi network. 


Note that GPS antennas exist in two breeds: active and passive. Active 
antennas need a ghost power supply feeding circuit made with a 
few passive components, which can usually be found in the module 
vendor's reference schematic. 


Ordering a Shot 

Now that we have all these topics sorted out, it is time to produce actual 
hardware. Depending on the relationship between you and the comms 
module vendor's field application engineers mentioned above, you 
can send the PCB design and the schematic for reviewing. The author 
was especially impressed by the review services provided by Quectel. 


The main problem when populating a prototype by hand is soldering 


the parts. While the author managed to solder some modules in his 
reflow oven, stencil- and part placement accuracy and the lack of X-ray 


RELATED PRODUCTS 


» SeeedStudio RF Explorer 3G Combo - Handheld Spectrum Analyzer (SKU 19099) 
www.elektor.com/seeedstudio-rf-explorer-3g-combo-handheld-spectrum-analyzer 





inspection equipment make this a Job which is better outsourced to 
a company specialized in building prototypes (along with a reminder 
to perform an X-ray inspection). 


When the assembled prototype is of the USB-dongle-type, use a 
self-powered USB hub for initial testing — this protects your expen- 
sive workstation from damage to its motherboard. 


Get the Job Done 
As in so many other tasks, getting started is the main hurdle to 
overcome. Almost all the designs done by the author worked at either 
the first or second attempt. However, getting the design to work is 
only a small part of the complete solution — software problems, for 
example, may complicate system integration. Nevertheless, have no 
fear. Armed with the experience the author gathered the hard way and 
presented here, you too can get the job done. I4 
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CARRIER AND 
GOVERNMENT CERTIFICATION! 


Depending on how good a citizen you try to be, finishing 
the design might require some certification to be done. This, 
however, is subject of a different story altogether. 


Questions or Comments? 
Do you have questions or comments about this article? 
Contact Elektor at editor@elektor.com. 


Contributors 
Idea and Text: Tam Hanna 
Editor: Clemens Valens 


Layout: Giel Dols 
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SOFIWARE 





Tracking Time 
with ESP32 and logg 


Working with the M5Stack 













In modern times, especially if you are 
working from home, tracking your tasks 
and the time you spend on them can help 
you keep focus. Doing so also makes it 
easier to discuss your work, whether it is 
with your colleagues or your customers. 
There are many solutions on the market 
— like openTimetool, Toggl and Kimai — 
that offer time and project tracking that you 
can also use to generate bills for custom- 
ers. For this article, I used the Toggl track 
web service, a web-based solution that also 
offers a plugin for your web browser or an 
app for your phone to track time. It offers an 
open API to interface with a time tracking 
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system, which enables you to build your 
own app or hardware device for tracking 
time using the company’s services. 


KISS 

“Keep it simple stupid” (KISS). For a 
time-tracking system, this is the best you 
can offer to a user. Keeping track of time 
is, for some of us, more of a task that we 
need to do than something we like to do. 
We need just one button to press for being 
at work and one to end should be simple 
enough. Since Toggl is an online service, 
we need something that can connect to 
the Internet (wirelessly or via wires) and 


By Mathias Claußen (Elektor) 


It is helpful to be able to track the hours 
you spend on electronics projects. This 
can be done with various services. 
We use Toggl.com here to show you 
how to make web requests using 
HTTPS and how to implement 
basic GUI functions. It is all 
done with the MsStack, 
providing a fast prototyping 


and development platform 
for ESP32-based projects. 


Figure 1: M5Stack Core. 


then submit our request. The ESP32 comes 
to mind for this task. To avoid a mess of 
wires and components on a bread board, we 
follow the KISS route and grab an M5Stack 
Core Basic (Figure 1), whose documenta- 
tion is accessible online [1]. In addition to 
the EPS32, we get three buttons, a display, 
a battery, and some other peripherals in a 
nice compact enclosure. All that seems to 
be left is just few lines of code. 


Basic Concept 

We simply need a device that can access 
the Toggl web service and react at least 
to one button to signal at work or out of 


Button 


Toggl API 


Figure 2: Dataflow to Toggl service. 


office. With the MsStack, this means we use 
Wi-Fi for Internet connectivity, as an access 
point is within reach, and we can assume to 
be permanently online. As you can see in 
Figure 1, we have three buttons to choose 
from. And since there is an LCD that can be 
used, why not display some graphics and 
indicate the work status (working or out of 
office)? How hard can accessing Toggl be? 
In theory, not that hard, as the API is well 
documented. This means pressing a button 
and sending an appropriate command to 
the Toggl web service. This is followed by a 
change of the status and this will displayed 
back to the user. It sounds simple in the first 
place. Figure 2 shows the current data flow 
from a button press to the Toggl API. For an 
LCD update with the current information a 
flow is shown in Figure 3, having one flow 
to the Toggle server, somewhere in the net, 
and back to the ESP32. This sounds simple 
and looks simple also. 


For the Wi-Fi part, this has been done 
many times and we grab the code for many 
Elektor projects that use an ESP32 inside. 
This provides us with a modular webserver, 
an attached mechanism to handle time and 
OTA updates, which is more luxury than 
is needed. A stack of protocols is used 
for the communication with the Toggl 
service. Figure 4 shows the communi- 
cation stack and the involved libraries. 
The ESP32 Arduino framework comes for 
network communication with a WIFICIi- 
ent library that allows for a connection to 
servers that can be reached by the Wi-Fi 
the ESP32 is connected to. On top, you have 
the HTTPClient library that will manage 
the HTTP protocol and HTTP request, also 
included in the ESP32 Arduino framework. 
As Toggl requests data to be exchanged over 
HTTP inJSON format, we need an addition 
library to handle JSON. In this case, we use 
the ArduinoJSON library on top. 


Besides the communication we also need 
a library to drive the Display inside the 


M5Stack 
ESP32 





Internet 
Toggl 
Webservice 
Internet 


Figure 3: Dataflow to get current status. 


MsStack. A library that works with the 
MsStacks display and is already known is 
the TFT eSPI that will deliver a wide set of 
out-of-the-box functions for drawing graph- 
ics. Asthis one is compatible, provides all 
required functions to draw text and graph- 
ics, and has been used in former projects, 
it would be a waste not to use it. A brief 
overview ofthe graphic stack that the TFT - 
eSPI offers is shown in Figure 5. 


To get started, a brief introduction to 
several topics will be helpful. I will begin 
with HTTP which is required to access the 
Toggl service. 


HTTP 

Hypertext Transfer Protocol (HTTP), which 
was developed back in 1989 at CERN, is used 
to request a resource by a client (e.g., your 
web browser) and get a response from a 
webserver. For example, if you want to 
open www.elektor.com, your client sends a 
request to the webserver. To do this, a TCP/ 
IP connection is established and a request 
string is sent as shown in Listing 1. 


The first line, an HTTP Header with GET, 
tells the server that we request something. 
The / tells the server that we want the 
default webpage delivered. With HTTP/1. 1, 
we tell the server that we talk HTTP in 


JSON Data ArduinoJSON library 
HTTP Requests HTTPClient library 


Cryptography 





ESP32 network stack 


TCP/IP Stack 


Figure 4: Protocol stack and libraries. 


WiFiClientSecure library 








Listing 1. HTTP request. 
GET 7 HYITP/1.1 

Host: www.elektor.com 
User-Agent: curl/7.55.1 
Accept: x/x 


version 1.1. Work has begun on HTTP/3 (the 
third protocol generation), but for most of 
our use cases, HTTP/1.1 is sufficient. 


For the second line, the Host, it is good 
to know that the names you type in your 
browser are translated by a DNS service to 
an IP address. This means elektor.com will 
translate to 83.96.255.227, the IP address 
used for the TCP/IP connection. Behind 
this IP address can be one webserver that 
will not only handle elektor.com but also 
elektor.de or elektor.nl. To enable the 
webserver to know which page you want, 
the second line with Host is required. 


With User-Agent in line 3, we tell the 
webserver what kind of HTTP client we are, 
in this case curl. This allows a webserver, 
for instance, to present pages that are 
optimized for your web browser, because 
Safari behaves differently than Firefox. The 
last HTTP Header in line 4 tells our client 


TFT eSPI 








ESP32 SPI Driver 


| 


Figure 5: Stacked drawing functions for the LCD. 
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Listing 2. HTTP response. 
HTTP/1.1 200 OK 


Server: 


Date: Tue, 


unknown 
17 Nov 2020 13:34:04 GMT 


Content-Type: text/html; charset-UTF-8 
Transfer-Encoding: chunked 


Connection: keep-alive 


X-Content-Type-Options: nosniff 
A-XSS-Protectd2on: 1; 
X-Frame-Options: SAMEORIGIN 
Strict-Transport-Security: max-age-63072000 


Pragma: 


Expires: =1 


no-cache 


mode=block 


Cache-Control: no-store, no-cache, must-revalidate, max-age=0 


Accept-Ranges: bytes 


Strict-Transport-Security: max-age=63072000 




























































































































































































Index Binary Encoded 
0 000000 A 
1 000001 B 
2 000010 C 
3 000011 D 
4 000100 E 
5 000101 F 
6 000110 G 
7 000111 H 
8 001000 | 
9 001001 J 
10 001010 K 
11 001011 L 
12 001100 M 
13 001101 N 
14 001110 O 
15 DOIIII P 
16 010000 Q 
17 010001 H 
18 010010 S 
19 010011 T 
20 010100 U 
21 010101 V 
22 010110 W 
23 DIOTLII X 
24 011000 Y 
25 011001 Z 
26 011010 a 
2/ 011011 b 
28 011100 C 
29 011101 d 
30 011110 e 
31 DIILTIII f 
32 100000 g 


Index Binary Encoded 
33 100001 h 
34 100010 i 
35 100011 j 
36 100100 k 
or 100101 | 
38 100110 m 
39 100111 n 
40 101000 O 
41 101001 p 
42 101010 q 
43 101011 r 
AA 101100 S 
45 101101 t 
46 101110 u 
47 101111 V 
48 110000 W 
49 110001 X 
50 110010 y 
51 110011 Z 
52 110100 0 
53 110101 1 
54 110110 2 
55 119111 3 
56 111000 4 
Df 111001 5 
58 111010 6 
59 111011 7 
60 111100 8 
61 111101 9 
62 111110 t 
63 111111 / 

PADDING = 








Table 1, BASE64 encoding table. (Source: https://tools.ietf.org/html/rfc2045Z'section-6.8) 
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to accept all kinds of content. Every HTTP 
request is ended by an empty line. 


At this point, the webserver will form an 
answer to our request, also starting with a 
set of HTTP headers as seen in Listing 2. 
The first line presents the protocol version 
and a response code. As we have asked for 
HTTP/1.1, the server will answer also in this 
protocol version. The response code we get 
is 206, signaling that our request could be 
processed. This is followed by more headers 
that give additional information. 


If we are just interested in the content 
requested, we can skip the header. The 
header is separated with one empty line 
from the content we have requested 
(content not shown in Listing 2). In case 
you are wondering, up to 8 KB and even 
more data can be just in the header itself. 
The body and length can be determined by 
Transfer-Encoding: chunked Or Content- 
Length:«length» where the first is used for 
content of unknown length, like dynami- 
cally generated webpages, and the latter 
used for content where the size is known 
in advance, like pictures. 


There are more http methods like a POST, 
where data is transferred from the client to 
the server. This will be used if you submit 
information on a web form. Also the PUT 
method may be used to transfers data 
to a webserver. More information can 
be obtained from the Mozilla Developer 
Network [2] for more methods that are 
defined. 


From HTTP to HTTPS 

One thing that was not addressed as HTTP 
was developed was integrated security for 
the communication protocol. The informa- 
tion is transmitted as plain text and every- 
one with a bit of network knowledge can 
extract or alter them. HTTPS, where the 
"S" stands for secure, added an additional 
layer to the communication stack. The 
server and the Client still talk using the 
HTTP protocol, but instead of having a 
plain text communication over a TCP/IP 
connection, all traffic between both parties 
is handled first by Transport Layer Security 
(TLS), which will manage the exchange of 
cryptographic keys and encryption. 


This also means we need more compu- 
tational power, flash and RAM if we are 
using HTTPS, as encryption and decryp- 


tion now need to be done and the added 
routines for TLS must be included in our 
software. On a modern computer, there 
is enough calculation power included. 
Smaller embedded systems will experience 
slowdowns in communication if encryption 
and decryption, as well as key management 
and exchange, are done purely in software. 
Therefore, on modern MCUS, you will find 
cryptographic accelerators that offload the 
encryption work form your MCU. For the 
ESP32, hardware acceleration is available 
to rapidly speed up this process. 


Request and Response 

The Toggl service offers an open and 
documented API [3] to exchange data. 
The API works by submitting POST, PUT 
and GET requests to a URL with defined 
Header and payload. All actions require a 
key to authenticate that can be obtained 
from the Toggle webpage. With the infor- 
mation provided, building a request can 
begin. We use the WiFiClientSecure class 
in conjunction with the http client object. 
This provides a proven way to communi- 
cate with the server and avoid reinventing 
the wheel when it comes to processing http 
data. 


What we do by hand is generating the 
authorization token, a Base64 encoded 
combination of username and password. 
As input for the Base64 encoding it takes 
an API key and : api. token as a string. We 
can get the API key from the Toggl service. 
As this is not going to be sent in plain text, 
it can include characters that will interfere 
with the reserved character for the header 
itself. To include data of any kind in these 
requests, the solution is a BASE64 encoding 
of data. Usually, our data inside a byte can 
have a value between 0 and 255. BASE64 
will only use 64 values (see Table 1 for a 
translation table) that are mapped to the 
equivalent of the ASCII letters A-Z, a-z, 0-9, 
+,/ and = for padding. For example, if we 
encode Elektor as a string into BASE64, we 
will get RWxla3Rvcg== (as seen in Figure 6). 
It must be noted that e-mail attachments 
are also encoded with BASE64 for similar 
reasons, and as you can see from the 
sample, it will increase the attachment 
size by approximately 37% from the origi- 
nal size. 


With the credentials passed to the HTTP 
client for authorization, now the request 
can be made. The following example 





Figure 6: Elektor encoded in BASE64, 


shows how to implement a GET request 
and process the returned information. 
The snippet in Listing 3 will give some 
insights. The cET () function will return 
the servers response code for our request, 
or if we have a communication problem, 
a value less than zero. The response code 
can have values in different ranges, as [4] 
shows. The most commonly known code 
is 404 Resource not found. Here, code 200, 


Listing 3. Snippet for HTTP request. 
httpclient.begin(client, Link); 
httpclient.setReuse(true); 


Response okay, is expected and checked for. 
If data is received from the server, it can 
be retrieved with getString() for further 
processing. 


Similar code exists for PUT and POST, with 
some minor but important differences, 
as shown in Listing 4. The addHeader 
function used prior to the PUT () will add 
two additional headers to the request. 


httpclient.setAuthorization((const charx)b64.c str()); 


int httpCode = httpclient.GET(); 


if (httpCode > 0) { //Check for the returning code 


if(httpCode!-200)1 


Serial.println("Response Error"); 


String payload = httpclient.getString(); 
Serial.println(httpCode); 


Serial.println(payload); 


*error = 1 


+ else{ 
xResult = httpclient.getString(); 
j 
} else (1 


Serial.print("Request Error"); 
Serial.println(httpclient.errorToString(httpCode)); 


j 
httpclient.end(); 


Listing 4. Added HTTP header. 


httpclient.setAuthorization((constocharx)b64.c str()); 
httpclient.addHeader("Content-Type","application/json") ; 
httpclient.addHeader("Content- length" ,"9") ; 
int httpCode = httpclient.PUT((uint8, tx) (NULL) ,0) ; 
if (httpCode > 0) { //Check for the returning code 








Oo 
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Being the first Content-Type and telling the 
webserver what type of data we will send to 
it, the second is the Content-length, and this 
is where HTTP suddenly gets a bit differ- 
ent than what we have seen before. Usually, 
we will transmit after the header data that 
can be text separated by two new lines and 
ending with two new lines. This works for 
text, but if we now send a JPEG image to the 
server it can consist of any combination of 
arbitrary bytes. This is where the Content- 
length comes into the picture. Headers 


Listing 6. JSON String example. are arranged and separated by two new 
{ "name": "Test", "value": 1351824120,"array": [ 123.45, 321.89 ] } lines from our data. With Content-length 
set you can send any kind of character or 


binary data. The webserver has been told 
how many bytes he has to expect with the 


Listing 5. Reuse connection. 
httpclient.begin(client, link); 
httpclient.setReuse(true); 
httpclient.setAuthorization((const charx)b64.c str()); 
httpclient.addHeader ("Content-Type","application/json") ; 
int httpCode = httpclient.POST (payload) ; 

if (httpCode > 0) { 


Listing 7. JSON generation. provided Content-length. 
DynamicJsonDocument doc(capacity) ; 
JsonObject time entry = doc.createNestedObject("time entry"); For the POST, we only need to supply the 
if (description. Length()>0) { content type that will be transferred. No 
tine entry "description" | = description. c_str() ; actual payload will be transmitted. If we 
} would supply a payload or content that is 
time_entry["created_with"] = "ESP32"; larger than o bytes, the http client would 
serializeJson(doc, payload); add a Content-Length header by its own. In 


this special case, having the length set to 
Zero, as we do not send content, it is not 
adding the content length header at all. 


Lisitng 8. DeserializerJSON. Since the server will complain if the content 
DeserializationError er = deserializeJson(doc, Result.c str()); length is missing, we need to add it on our 
if (er) 1 own with the addHeader function, as shown 
//something went wrong in Listing 4 
) else { | 


if(false == doc["data"].isNull() ){ 
JsonObject data = doc["data"]; 
uint32 t data id = data["id"]; 
const charx data start = data["start"]; 
if(false == data["description"].isNull()){ 
const char» data description = data["description"]; 


As you can see in Listing 5, setReuse() is 
setto true. After this request, either POST, 
PUT or GET, the connection to the server 
will normally be closed by the client. With 
setReuse() set to true, this connection will 


ELement-»description = String(data, description); be kept open and reused for the next time 


) else { a request will be made. This saves time as 
Element-»description = ""; the connection is not required to be reestab- 
} lished if the next request needs to be done. 


Also, at the time of writing, this hides a bug 
somewhere inside the network stack, where 
memory is not properly released. Sooner or 


Listing 9. Toggl JSON-String. later, this can cause connections fails as the 

i ESP32 runs out of free memory. 

"data": 

( Data Exchange with JSON 

"id":436694100, JSON stands for JavaScript Object Notation 
"pid":123, and describes a way for lightweight data 
"wid": 777, to be exchanged between two systems. All 
"billable": false, data will be packed into a string that can 
"Start":"2013-03-05T07:58:58.0007", look like the one in Listing 6. This string 
"duration":1200, needs to be generated and parsed. Most 


"description":"Brew some coffee", 


environments that process and exchange 
"tags": ["b1Lled"] 


data for web applications use JSON and 
have built-in functionality or additional 
ready-made libraries for JSON generation 
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and parsing. This is also true for small 
devices like an Arduino or ESP32. 


A library that is usable with the Arduino 
Framework and the ESP32 is ArduinoJSON 
and can parse and generate JSON strings 
to be exchanged with other systems. As 
Toggl uses JSON to exchange data, this 
library comes hand for our needs. From the 
Toggl API, we can determine the informa- 
tion expected to be inside JSON strings. This 
documentation also describes how data 
must be generated if information needs 
to be sent. For a new time entry, we need 
to generate a JSON string that has a time _ 
entry object init. Insidethistime entry we 
need a description string and an optional 
created with string for the new entry. 


The code in Listing 7 will create a new 
DynamicJsonDocument doc with a defined 
capacity on the heap of the ESP32. This 
means memory is allocated with malloc() 
and later released with free () from the not 
statically used memory of the ESP32. The 
opposite is StaticJsonDocument that will 
be allocated static in RAM or if used locally 
in a function will be placed on the stack. 
While StaticJsonDocument is faster, as it 
is locally bound to the stack it means that 
the size can belower than what we can use 
with Dynamic/sonDocument. The function 
serializeJson() will create the desired 
string that can be sent. 


Decoding a JSON can be done with 
deserializeJson() and it will return any 
error it may encounter while parsing. The 
code part is shown in Listing 8. Access- 
ing the elements within the JSON can be 
seen above. The string returned by Toggl 
looks like this one in Listing 9. The code 
will check after deserialization if the object 
data exists, meaning if we have a valid 
result. Afterwards the code accesses the 
elements inside data and only grabs the 
values needed later for display and data 
handling, being id, start and description. 
The last one is special, only if this field 
holds a value within the Toggl database it 
is integrated into data. This requires with 
data["description"].isNull() to validate 
that the entry does exist before we will try 
to access them; otherwise, the library will 
generate an exeption. 


The complete data exchange is encapsulated 
into the toggleClient lib. Here it supports the 
bare necessities, showing the current entry, 


starting anew one and stopping the current 
running entry. The code is not perfect and 
and everyone is welcome to contribute 
improvements and error corrections, as 
this is more meant to be a starting point 
than a finished library. Besides collecting 
and submitting data, they need also to be 
displayed and that is what is next. 


Drawing Pixels 

For drawing, the TFT eSPI library is used, 
which you might remember from an older 
Elektor project, GUI with Touch [5], and can 
be used with various displays and ESP32 
combinations. As this library supports the 
MsStack’s display some code from other 
projects can be reused. Inside the library 
folder, the file User Setup Select.h needs to 
be modified to use the included configura- 
tion for the M5Stack. Inside TogglButtonMs. 
ino the line TFT_eSPI tft = TFT_eSPI(); 
will create a new TFT eSPI object that can 
later be used for drawing. 


For the display initialization, we need 
only four lines of code inside our setup() 
function, as seen in Listing 10. The 
inverted display needs to be set to true 
to transmit the right color ordering for the 
MsStacks display. With setRotation(1) the 
screen will have its lower end where the 
MsStacks buttons are located. After this 
line of code all possible pixel manipulation 
offered by the library can be used. 


A small hint for drawing performance, 
especially for the ILI9341-based display. 
These displays are optimized to process 
full display images or bigger chunks of 
display data. Access pixel by pixel will slow 
down drawing at least by seven times, even 
more. This is due to the way commands 
and access to individual pixels must be 
issued. The TFT eSPI library offers already 
optimized drawing on the ESP32 and will, 
where possible, optimize access times. 


Besides setting pixels or filling the screen 
with single colors, the library will also add 
other drawing functions like lines, rectan- 
gles and using print functions to draw 
strings on screen. And if someone asks 
why you are using a library for this task and 
not writing a driver, you can reply: never 
reinvent the wheel. 


The GUI and a Menu 
The MsStack features a display and three 
buttons. Time-tracking solutions usually 


Listing 10. LCD initialization. 
trt.mTEC)3 
tft.invertDisplay( true ); 
tft.setRotation(1) ; 
tft.fillScreen(TFT. WHITE) ; 


provide only a single button for starting 
and stopping an entry. Since the M5Stack 
can also run on battery power, having 
a shutdown button can be very handy. 
Figure 7 shows the GUI concept and the 
rough positions for the few items to display. 


As drawing text is quite simple, the 
question becomes: What we are going to 
display? The essential items to display are 
the description, if we have one, and the 
start time. For the icons, we are going to 
use those from the open icon library [6] and 
the resulting main screen can be viewed 
in Figure 8. This allows us to start a new 
entry, stop it, and power down the device. 
This keeps the device simple to use. 


Information text 


Icon Icon Icon 





Power down 


Stop Entry 


start Entry 


Menu 









Description 


> Entry D 
Entry 1 
Entry 2 
Entry 3 


Scrolbar 


Select 


Down Up 


Up & Down - Exit 
Figure 7: Concept drawing of the GUI. 
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Figure 8: GUI main menu. 





Figure 9: GUI description selection. 
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Figure 10: Flowchart menu system. 
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As we can start a new Toggl entry, it will 
have no description inside. Basically, that 
is all we need, but a bit of luxury would be 
great, at least to choose from some pre-de- 
fined descriptions. But entering descrip- 
tions with only three buttons is possible but 
not user friendly. A total overhaul based on 
the 3-Way Display Clock project [7] featured 
a simple menu system to be used with the 
TFT eSPI library. The screen resolution 
and orientation of the menu system also 
matches the configuration we have for the 
Toggl button. Code can be transplanted into 
this project to present a menu like the one 
you see in Figure 9. 


Listing 11. ShowMenuSettingsList. 


The menu is not a universal, flexible one 
like you would find in a GUI framework. 
It is lightweight, works with the TFT eSPI 
and has been built to be used with only 
a few buttons. If there would have been 
more time to spend, I would have used 
the LVGL (Light and Versatile Graphics 
Library) [8], because it also works for 
displays without touch. As we have a 
self-made menu system, let's consider 
how it works and how the graphics are 
drawn. The logic for the menu resides 
in a RenderMenu () function. Depending 
on the state, it will draw the menu and 
return true. If no menu is drawn, the 


void Menus: :ShowMenuSettingsList(uint8_t selected idx, bool refresh) { 


/* Draw Headline x/ 


if(true == refresh) { 


_led->fillRect(0,0,320,40,_lcd->color565( 45,47,50 ) ); 
,DLed-»setlextColor(.lcd-»color565( 112,116,122 ),TFT.BLACK); 


_lcd->setFreeFont(FSB18) ; 


_lcd->setCursor(160- ( _lcd->textWidth("Description") / 2) 


_lcd->print("Description") ; 
} 


/* Headline done x/ 


/* Draw scrollbar x/ 


sou); 


_lced->fillRect (303,43,15,197,TFT_WHITE); 

_led->drawRect (300,40,20,200,_lcd->color565( 112,116,122 )); 

.Led-»drawRect(301,41,18,198, lcd-»colorb65( 112,116,122 )); 

_led=rdrawkect (302,42 ,16,196,.. led=>colors65( 112,116,122 )); 

_lcd->fillRect(305,45 +(196/GetUsedEntryCount())*xselected_idx 
, 10, (196/GetUsedEntryCount())-2 , TFT_DARKGREY) ; 


/* Scrollbar done x/ 


/* Menu entries x/ 
uint8 t startidx-0; 
uint8 t endindex-0; 


if(selected idx»4)[ //We can display 5 Elements 


Startidx = selected_idx -4 ; 


J 


if((startidx+5)>GetUsedEntryCount()){ //Limit last drawn item 


endindex=GetUsedEntryCount(); 


lelsei 
endindex-startidx-*5; 


j 


/*Draw up to five elementsx/ 


for(uint8 t i-startidx;i«endindex;i-*-*)1 
DrawSettingsMenuEntry( (40x(i-startidx)) 


,DescriptionArray[i].c str() 


J 


/* Menu entries drawn x/ 


,( 1==selected_idx ) ); 


function will return false, indicating 
that the content of the display has not 
been altered. If true is returned, it should 
be avoided to do any additional drawing 
afterwards. A simplified flowchart can 
be seen in Figure 10. 


in pixels and subtracting the value from the 
half display width. This works if the text 
is less than 160 pixels and can produce 
unknown results if the text is longer. The 
second one is the scroll bar, drawn at the 
right side of the menu. The scrollbar is 
composed of a few rectangles. The scroll- 


The software was not written from scratch. 
I reused parts from former projects. This is 
also true for the web-based configuration. 
If the two left buttons are pressed during 
boot, the software will start an access 
point you can connect to with a computer 


The RenderMenu() will therefore holdthe bar length is calculated from the number or portable Wi-Fi-enabled device. Other- 
menu logic, but the drawing partisdone — ofitems used inside the menu.Thisalso wise, the software will try to connect to 
with ShowMenuSettingsList().This works ifthere are less than 196 entriesin the Wi-Fi network that was configured, if 


function will draw the menu head and 
up to five menu entries. The menu logic 
ensures the selected item stays in a valid 
range. Thus, the drawing routine calcu- 
lates the starting position and draws five 
entries asa list to the screen. Also, a scroll- 
bar, as seen in many other Windows-based 
systems, will be calculated and drawn with 
a small indicator for the position inside the 


fn 


list. The code of ShowMenuSettingsList() 
is shown in Listing 11 and can be divided 
into three parts. The first one being the 
headline. To save processing time this is 


only redrawn when required. 


Centering the headline text is done 
manually by calculating half the text length 


the list, otherwise unpredictable results can 
be calculated. 


For the third part the stat index and the 
end index for the list entries to be drawn 
are calculated. As we can only draw five 
elements, we need to shift that range 
accordingly with respect to the user-se- 
lected index. The three parts are respon- 
sible for the list that is displayed. As every 
entry inside the list looks the same, this 
entry is drawn with its own function 
that only needs an offset for drawing at 
the correct height and a flag if this entry 
is selected. This generates a slim menu 
system that works for this purpose and 
shows some basic menu concepts. 


any. Starting a webserver can be simple on 
the ESP32, and it is done by the software 
after the Wi-Fi starts and presents us with 
a web interface, allowing us to set the Wi-Fi 
network (Figure 11) and enabling a Toggl 
API key for user authentication (Figure 12). 


While the Toggl button works and enables 
the effective time tracking, there is still 
room for improvement. In this article, I 
have touched on only a few of the many 
aspects of modern IoT devices, especially if 
they interact with any kind of webserver or 
web browser. Terms like Wi-Fi, HTTP server, 
HTTP client, TLS, JSON, JavaScript, HTML, 
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Network settings 
TP-Link Guest D99C v 
SSID LN 


Refresh 





Password | 


Connect Clear WiFi Settings 





Figure 11: Wi-Fi configuration page. 


GUIand C/C++ may sound like buzz words, 
but they are acutally the essential ingredi- 
ents for this simple project. Dealing with 
HTTP and HTTPS, JSON on one side and 
GUI design on the other, while also provid- 
ing a web-based configuration interface, 
was uncommon in the early days of the IoT. 
But today, doing so is the bare minimum for 
a connected device. This mixture of differ- 


RELATED PRODUCTS 


> M5Stack - ESP32 Basic Core Development Kit 
www.elektor.com/mbstack-esp32-basic-core-development-kit 


> M5Stack ESP32 Arduino MPU9250 Development kit 
www.elektor.com/mbstack-esp32-arduino-mpu9250-development-kit 


ESP32 Toggl Button 


Toggl API Key | 090090000000000001 





Set API Key Clear API Key 





Figure 12: Toggl API key. 


ent fields — including basic web develop- 
ment, JSON, HTML, C/C++ and JavaScript 
— could fill an entire book. And if such a 
book is published, Elektor will report on it. 


While writing this article, I came up 
with some ideas for making the button 
even more user friendly and for adding 
functions that will improve accounting. 





» W.Gay, FreeRTOS for ESP32-Arduino (Elektor 2020) 


www.elektor.com/freertos-for-esp32-arduino 


—. WEB LINKS 


[1] Mb5Core Basic: https://docs.m5stack.com/#/en/core/basic 
[2] HTTP | MDN: https://developer.mozilla.org/en-US/docs/Web/HTTP 


[3] Toggl.com API Documents: https://github.com/toggl/toggl api docs 
[4] HTTP Response Status Codes | MDN: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status 


[5] GUI with Touch: www.elektormagazine.com/articles/guiwithtouchforesp32rpico 


[6] Open Icon Library: https://sourceforge.net/projects/openiconlibrary/ 
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] 3-Display Alarm Clock with TFT Screen: http://bit.ly/elektor-3display-alarm-clock 
[B] Light and Versatile Graphics Library: https://lvgl.io/ 
] GitHub Project Page: https://github.com/ElektorLabs/200631 ESP32 Toggl Button 





The fist improvement would be the GUI 
switch to LVGL. For the GUI, this brings us 
fast to lessons learned. If you want to add 
a GUI to your project, look for something 
that is proven and available. There are even 
solutions that have a friendly license for 
your project. Implementing your own menu 
system for the fun of learning may be great, 
but reinventing the wheel is not. 


For the ESP32, if you are using the Arduino 
framework and libraries, consider looking 
at its GitHub repository and the open 
issues. This can be a good resource for 
avoiding problems or working around 
known limitations. The code for this Toggl 
button is posted on the Elektor GitHub [9] 
page and offers a convenient way to clone 
and explore the code because its history is 
preserved. If you find bugs or have sugges- 
tions for the code, you can use the GitHub 
issues function. As this project touches 
many topics, give me some feedback if there 
are topics that should be explained in more 
detail in a future article. I 
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Raspberry Pi Pico Board 


ana RP2040 


By Mathias Claufen (Elektor) and Luc Lemmens (Elektor) 


The Raspberry Pi is well known as a single-board 
computer (SBC) running Linux on it, but the new 
Raspberry Pi Pico is different. While still a Raspberry 

Pi, Pico is entering a world where the Arduino, the 

STM32 BluePill board and ESP32 set the standards in terms 
of price, the software ecosystem, or connectivity. The 
Raspberry Pi Pico is a bridge from your high-power Linux- 
based SBCs to the world of embedded microcontrollers. 
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Another Raspberry Pi? Yes. Now there is a new Raspberry Pi product 
— Raspberry Pi Pico (see Figure 1). We will say in advance: the 
Raspberry Pi Pico is not meant to replace any existing Raspberry 
Pi; itis meant to be an extension and a companion for the exist- 
ing Raspberry Pi family. Although it is a Raspberry Pi, this one 
is completely different from what we have seen until now. The 
Raspberry Pi Pico is a dual-core ARM powered board that offers just 
the bare circuitry to make it work. Even if it sounds like a modified 
Pi Zero, itis not. The Raspberry Pi Pico is not using a Broadcom 
CPU like the other Raspberry Pi boards we have seen. This one uses 
a chip, the RP2040, that was designed in-house by the Raspberry 
Pi Foundation itself. 











Watch Elektov’s 
“Raspberry Pi Pico Review” 
on Elektov. Tv! 


Figure 1: A view on the Raspberry Pi Pico. 


The RP2040 is a dual-core ARM Cortex-Mo+ microcontroller. 
This core is not a Linux-capable SoC like we have seen before. The 
Raspberry Pi Pico is entering the field of microcontrollers, where 
Arduinos, STM32 BluePill boards, and ESP32-based boards are most 
used nowadays, while RISC-V-based SBCs (like the GD32VF103) are 
getting increasingly popular. This one is affordable, with a pricetag 
of around €5, which puts in it in the range of a cloned Arduino 
Nano and the STM32 BluePill. And it is less expensive than an 
ESP32 Pico Kit. 


In this article, we'll have a look at the specifications and features 
of the Raspberry Pi Pico and its RP2040. Be sure to check out the 


——O 
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1.1. Why is the chip called RP2040? 


The post-fix numeral on RP2040 comes from the following, 
1. Number of processor cores (2) 
2 Loosely which type of processor (M0+) 


3. floor(log2(ram / 16k)) 


4. floor(log2(nonvolatile / 16k)) or 0 if no onboard nonvolatile storage 


floor(log2(nonvolatile / 16k)) 
floor(log2(ram / 16k)) 


— > 


Type of core (e.g. M0O+) 
Number of cores 


Raspberry Pi 


Figure 2: Naming scheme [9]. 


Home Share View Drive Tools 
^t sw > RPI-RP2 (H:) v O Search RPI-RP2 (H:) 
^ 
Name Date modified Type Size 
xt Quick access 
B INDEX.HTM 05.09.2008 17:20 Firefox HTML Doc... 1KB 
E This PC [E] INFO_UF2.TXT 05.09.2008 17:20 Text Document 1KB 


> = RPI-RP2 (H:) 


e Network 


2 items 


Figure 4: The Raspberry Pico as mass storage device. 


Table 1. Raspberry Pi Pico Features 














CPU type Cortex MO+ 

Core count 2 

Max speed 133 MHz 

SRAM 264 kB in 6 banks 





Flash internal 0 kB 





Flash external 2 MB QSPI flash (up to 16 MB supported) 
































GPIOs 26 (incl. 4 ADC) 

USB USB 11 Host / Device 

ADC 12 Bit @ 500 kSps 

ADC Channels 5 (incl. temperature sensor) 
SPI 2 

UART 2 

lC 2 

PWM 16 channels 

Timer 1x 64-bit 

RTC yes 





Programmable IO state machine, Boot ROM 


Uni feat . 
nique tearres | with USB mass storage bootloader 
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Figure 3: Inside the RP2040 [9]. 


unboxing video from Clemens Valens on Elektors YouTube channel 
[1] and a helpful overivew [2]. 


A first look into Raspberry Pi Pico 

As we already mentioned, the Raspberry Pi Pico features a dual-core 
Cortex-Mo+ microcontroller able to run up to 133 MHz. While 
dual-core Cortex-M MCUs are not uncommon these days, they 
usually don't have two Cortex-Mo+ inside but rather use the more 
powerful Cortex-M4, Cortex-M7, or the newer Cortex-M33 cores. 


The RP2040 MCU used on the Raspberry Pi Pico follows the naming 
scheme shown in Figure 2. We can only speculate what other parts 
may follow, as this suggests that there may be more variants to 
come. We asked the Raspberry Pi Foundation if more variants will 
follow, but we haven't received an answer yet. The technical speci- 
fications for this MCU are shown in Table 1. 


An overview of the peripherals and function blocks inside the 
RP2040 is shown in Figure 3. One of the unique things that may 
be overlooked at first is the absence of flash memory inside the 
MCU. On the Raspberry Pi Pico, there is a small IC next to the MCU 
— a W25Q16JUXIQ NOR-Flash with 2 MB storage. The RP2040 
supports up to 16 MB for external storage, so increasing storage is 
a matter of replacing the flash chip. The Raspberry Pi Pico features 
a USB Port that can be configured as Host or Slave in USB 1.1 mode 
(12 Mbit/s), allowing to attach USB peripherals or to act as USB 
device. 


The RP2040 contains a boot ROM, allowing the user to upload 
new code from a computer. To avoid any kind of special program- 
ming tool, the integrated bootloader will show up as mass storage 
device and the RP2040 can be programmed by simply copying new 
firmware files into the device (Figure 4), a simple and convenient 
way to program devices. 


The power supply is also user-friendly. You can power the device 
from 5 V through micro-USB. It also accepts voltages from 







Feed VSYS pin from 
external supply (V) via 
Schottky diode (D) 


Feed VSYS pin from 
external supply (V) 
via P-channel 


Figure 5: How the board can be powered [3]. 


1.8 V upto 5.5 V using an DC/DC Buck-Boost converter on its VSYS 
pin. This also allows the use of a rechargeable lithium battery or 
just a set of two or three NiMH batteries. From the datasheet [3], 
Figure 5 shows the options to connect various power sources. The 
DC/DC Buck-Boost IC used is an RT6150, whose datasheet can be 
found at [4] and makes it possible to operate with only a few compo- 
nents, as seen in the schematic shown in Figure 6. 


The 40 pins of the Rasberry Pi Pico are on the sides of the board, 
making 26 GPIOs, including three ADC inputs of the RP2040's IOs 
accessible. The other pins are for power and ground. The maximum 
IO voltage for the Raspberry Pi Pico is 3.3 V on all GPIO pins. On the 
bottom side of the PCB (Figure 7), every pin is labeled. There are 
three additional pins on the Pico board (SWCLK, SWIO and GND) 
for the Serial Wire Debug port, which allows for programming the 
RP2040 and also for debugging. 


Peripherals and the Programmable 

Input/Output block 

The Raspberry Pi Pico with its RP2040 includes a set of the most 
common peripherals you would expect to find: two UARTS, two 
I?C-Controllers, two SPI controllers, 16 PWM channels, a 12-bit 
ADC with 500 ksps, an integrated temperature sensor, a real-time 
clock, timer and the basic GPIO functions. Also included and less 
common is the USB interface, working as host and slave, and eight 
Programmable IO (PIO) state machines. 


The state machines can be used to implement various interfaces 
like (additional) UART, I*C, I?S, and SPI, but also SD-Card, VGA, 
DPI and many more. The RP20405 datasheet includes a dedicated 
section explaining their usage and example programs. Figure 8 
shows one block containing four state machines. These state 
machines can execute a set of nine commands: JMP, WAIT, IN, 
OUT, PUSH, PULL, MOV, IRQ, and SET. As these state machines 
can run independent from both CPU cores, it allows to form inter- 
faces not supported by the build-in hardware, while offloading 
work from the CPU cores. 











R10 D1 C1 

5K6 MBR120VLSFT1G 47u 

63mW M2012 

1% 6.3V 

M1005 XSR 
M1005 20% 

GPIO24 => 
R1 3V3_EN 


10K 
TW RT6150B-33GQW = 
M1005 


== R8 


Figure 6: The on-board buck/boost converter [3]. 
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Figure 7: Bottom view of the PCB, showing the pin names. 
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Figure 8: I/O with programmable state-machine [9]. 
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Event select Phase Phase 
Advance Retard 


Outout compare unit Output 
(level A) (pin A) 


















up/down Counter 
16b, programmable 
wrap 


Fractional Clock 


rEN>| Divider (8.4) 














Outout compare unit Output 
(level B) (pin B) 
Wrap 








Figure 10: An RP2040 PWM block [9]. 


The native UARTS in the RP2040 are based on the ARM Primecell 
UART (PLo11), which is also used on other Raspberry Pi boards, allow- 
inga maximum speed up to 961.6 kBaud. For the two SPI interfaces 
an ARM Primecell SPI (PLo22) is used that is also integrated in other 
Raspberry Pis. This interface can transfer data up to F CPU/2 SPI clock 
in Master mode. The I?C controller included supports Standard mode 
(100 kHz), Fast mode (400 kHz), and Fast mode plus (1 MHz) clock 
speeds with 7-bit and 10-bit addressing as master or slave. These three 
interfaces provide connectivity to most external hardware used and 
provide a good balance between functions and devices complexity. 


= Disable Flash boot 
(forces USB boot) 


Qi 
DMG 1012T 


ADC GPIO pins have diode to VDDIO (other GPIO do not) 
FET stops leakage through ADC3 pin diode into 3V3 net 
when 3V3 supply is off (VSYS present but 3V3 EN low) 





Figure 9: The board's schematic diagram [3]. 
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E PS=0; PFM mode (default, best efficiency) 
TP^ PS=1: PWM mode (improved ripple but much 
worse efficiency at light loads) 





The ADC in the RP2040 is a basic SAR with 500 ksps at 12-bit resolu- 
tion. It has four inputs and a temperature sensor. If you are used 
to the ADCs of an AVR (for example), you normally find a bandgap 
reference, providing 2.56 V or 1.1 V to your ADC as reference voltage; 
here the ADC_AVDD pin on the RP2040 is used. On the Raspberry 
Pi Pico board, this means an external voltage must be supplied 
asa reference. The implementation on the Raspberry Pi Pico is 
shown in Figure 9, as this pin is connected with a resistor to 3.3 V 
and some filtering. 


Another interesting feature is the USB interface provided on the 
RP2040 and therefore on the Raspberry Pi Pico. The Pico can be 
configured to be either host or slave it offers up to 12 Mbit/s transfer 
speed in USB 1.1 mode. This enables usage of USB devices like mice 
and keyboard and USB connectivity to a PC or Raspberry Pi. For 
the USB Host mode, the controller supports the use of USB Hubs, 
so you are not limited to connect just one device to it. 


The RP2040 has one dedicated 64-bit timer, that runs on a1 us time 
base. This allows to setup to four alarm timers or can be used to 
generate delays in us range. For repeating timed events or inter- 
rupts you can use one ofthe eight 16-bit PWM units, each with two 
channels. Figure 10 shows the block included in one PWM unit. The 
GPIO pins for PWM, can also be used for frequency and duty cycle 


ooo0o0o0c00000000000000 


ADC current = -150uA 

For best performance use 
external 3.0V shunt ref 
(e.g. LM4040) 

For lower offset (at expense 


of noise) connect VREF to 
3743 with lower resistance 
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measurement, to generate interrupts, DMA requests and feature a 
fractional clock divider for more accurate frequency adjustment. 


For more advanced programming the RP2040 includes a DMA 
unit that allows data transfer in the system without the interven- 
tion of the CPU cores. For example, AD-conversions and moving 
results to a pre-defined buffer in memory is possible without the 
CPU, or sending data from memory to a UART. Also copying larger 
number of buffers inside the RP2040 from one place to another 
can be done without the CPUs involved and are even faster than 
the CPUs could do. This also comes in handy if you need to shift 
data to an externally connected display. As the DMA unit can also 
be chained with the Programmable IO (PIO) state machines this 
forms a mighty setup for high-performance data exchange with 
external devices. 


Schematics, manuals and design files 

The Raspberry Pi Pico board is the first RP2040 board. Figure 9 
shows its schematic diagram. The MCU is surrounded with the 
DC/DC converter, external QSPI NOR-Flash memory, and some 
circuitry to measure supply voltage and to set the power converter 
into low power mode and an USB interface. 


The Raspberry Pi Foundation also supplies KiCad and Fritzing 
files to get started with your own designs. Interesting to see that 
you get a reference design that is not the Raspberry Pi Pico but a 
demonstration on how to make your own board with the RP2040. 
If you are designing hardware you know that for most other micro- 
controllers, no special attention was paid to the pin arrangement. 
However, with the RP2040, PCB designers will thank the Raspberry 
Pi Foundation for combining associated pins into groups that can 
easily be routed to external hardware. Figure 11 shows the pin 
arrangement, and you can clearly see that hardware design was 
also kept in mind. 


At the time we are writing this article, both manuals and software 
are not in final versions, so minor changes or additions might 
occur in the meantime. Nevertheless, you can clearly see that 
this is a Raspberry Pi product with documentation that is ready 
and complete from the beginning and the hardware is open. 
Besides this, it also means that from the beginning an open SDK 
is provided that allows development on your Raspberry Pi, your 
Linux- or Windows-powered PC, and an Intel-based Mac. Currently, 
to develop your own applications, you have the choice between 
MicroPython and C/C++. 


Developing with MicroPython 

Many RP2040 programmers will prefer C/C++ (or in the near future, 
the Arduino IDE, because support has already been announced). 
However, MicroPython is also an option if you want to program this 
microcontroller. First of all, you'll need a Raspberry Pi 4 running 
Raspberry Pi OS or — according to the manual — an equivalent 
Debian-based Linux distribution running on another platform. 
You can either build your own Raspberry Pi Pico MicroPython port 
following the instructions in the manual [5] or download a pre-built 
binary from the Pico getting started pages [6]. 


Connecting the board to the Raspberry Pi 4 using a micro-USB 
cable with the BOOTSEL button pressed presents the Pico board 
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Figure 11: RP2040 pinout [9]. 





Thonny - /home/pi/pico-micropython-examples-master/blink/blink.py @ 10:1 











File Edit View Run Tools Help | 
| «untitled» x | blink.py X | 

1 from machine import Pin, Timer 

2 

3 led = Pin(25, Pin.OUT) 

4 tim = Timer() 

5 def tick(timer): 

6 global led 


7 led.toggle() 


9 tim.init(freq=2.5, mode-Timer.PERIODIC, callback=tick) 
10 
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MicroPython (Raspberry Pi Pico) 














Figure 12: Thonny IDE running on an RPi 4. 






Figure 13: UART connection 
between an FP! 4 and an 
Raspberry Pi Pico [10]. 
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Figure 14: Visual Studio Code IDE on an RPI 4. 


as USB mass storage device. The binary file can then be dragged 
onto the board to program the flash. After this installation, you can 
connect to the Raspberry Pi Pico in the MicroPython Interactive 
Interpreter Mode (also called REPL) via USB or the Pico's UART. 


Alternatively, the MicroPython port to Raspberry Pi Pico and other 
RP2040-based boards works with commonly used Integrated Devel- 
opment Environments (IDEs) like Thonny (Figure 12). The manual 
contains instructions on how to install and configure this IDE for 
MicroPython programming with the RPi Pico. 


Are you interested in MicroPython? In the book Get Started with 
MicroPython on Raspberry Pi Pico (G. Halfacree and B. Everard, 
Raspberry Pi Foundation 2021), you will learn how to use Micro- 
Python to write programs and connect hardware to make your 
Raspberry Pi Pico interact with the world around it. (Refer to the 
Related products textbox.) 


Developing with C/C++ is intended to be done on a Raspberry Pi 4 
by the description and tools provided. Setting up a development 
environment on other systems is described in the manual [7], but 
for the Raspberry Pi a handy script can be downloaded [8] that will 
deal with all the steps required for installation. The connection 
between the Raspberry Pi 4 and Raspberry Pi Pico is done according 
to Figure 13. In this setup the Raspberry Pi 4 will act also as debug 
interface using a patched version of OpenOCD. If you like to use 
a PC or Mac, a debug probe can be built using a second Raspberry 
Pi Pico as described in the manual. 


62 May & June 2021 www.elektormagazine.com 


nyusb/src/portablLe/ 





inc Lude/boards/pico.h 
raspberrypi/rp2040; adding USB support. 





Those that like an IDE more than just developing ina shell, Visual 
Studio Code (Figure 14) will be installed by the provided script, 
offering an IDE to get started. At the time we are writing this 
article, following the examples has worked quite well, but the 
project generator to start new ones without having to do all kinds 
of stuff manually on a command line is not completely ready for 
prime time. Even if you may experience some small hick-ups at 
launch, like we have seen with the Raspberry Pi 4, there will surely 
be improvements over time as more users will use the provided 
software and report bugs. 


For the RP2040 arich set of libraries and examples is provided to 
get you started with the chip, so you do not have to write drivers for 
every part of the chip yourself. Also, for the USB the TinyUSB library is 
included and extended to support the RP2040, allowing a fast entry. 
The good thing is, as all the code is open, you can dig around the 
files and study how things have been done. If you are more used to 
an Arduino Wiring compatible framework, this has currently, at the 
time of writing, not arrived, but as for other non-Arduino platforms 
of interest, it will be a matter of time until this will show up. 


If you are running on a PC or Mac and want to start developing, the 
experience gained is to use a virtual machine to set up the develop 
environment. If you struggle at some points, you can switch back to 
a snapshot taken to have a known good system within a short time. 


Have you been staying away from microcontrollers because they 
seem to be expensive or less well documented? You do not have 


an excuse any longer. Grab some Raspberry Pi Picos while they 
are available and start coding. At a price of €5 per unit and with 
all the support and documentation provided by the Raspberry Pi 
Foundation, itis not a question of whether you should buy it, but 
rather how many Pico boards you should buy. Due to the acces- 
sibility of datasheets, development tools, examples, and begin- 
ner-friendly manuals, working with a Pico is quite enjoyable. It is 


DID YOU OVERLOOK THE 
LOW POWER SECTION IN THIS ARTICLE? 


This question sparked some discussion among the editors 
already playing with the Raspberry Pi Pico. Normally, one 

of the first things you'll find on a new MCU is the low power 
consumptions, and that usually is only a few hundred nA or 
some pA of current required for sleep mode. If you look at 
the RP2040 datasheet, it shows 018 mA of average current 
consumption in its deepest sleep mode. This may not sound 
that bad, and 180 pA is a value you can deal with; but for 

the Raspberry Pi Pico, there is a catch. On the board are 

not only the RP2040 but also the external flash and the DC/ 
DC converter. While the flash chip could enter a standby 
mode with 50 UA or even power down to 15 uA, the DC/ 

DC converter needs to be running at very low loads. This 
results in a standby current of 0.8 mA at 25 °C, as we can 

see in the data sheet of the Raspberry Pi Pico. This is 

just something you must consider if you intend to run the 
board from batteries for a long period of time. So, the low 
power section is not forgotten, but at some point, you need 
to have a sort of compromise in terms of features, power 
requirements and intended use. The perfect microcontroller 
does not exist, but the Raspberry Pi Foundation’s first silicon 
offers a promising look into what we can expect. For power 
optimizations the following time will show if and how the 
design may be tweaked to squeeze even a few pA more out of 
it for longer runtime. This is also true for software development 
and how to optimize your code not just to be fast but also run 
power efficiently on battery powered devices. 
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not restricted to experienced developers; it can be used to teach 
kids and students. If you start new projects with the board, let us 
know and share your experience. We are curious to see what you 
cancomeup with. M 
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Questions or Comments? 

Do you have questions or comments about this article? 
Please don't hesitate to write an e-mail to the authors via 
mathias.claussen(elektor.com. 
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» Raspberry Pi Pico Microcontroller Board 
www.elektor.com/rpi-pico-board 


» Get Started with MicroPython on Raspberry Pi Pico 
www.elektor.com/micropython-on-rpi-pico 


» Raspberry Pi 4 B (8 GB RAM) 
www.elektor.com/rpi4b8 


> Official EU Power Supply for Raspberry Pi 4 (black) 


www.elektor.com/eu-power-rpi4-blck 


> Official HDMI Cable for Raspberry Pi 4 (black, 1 m) 
www.elektor.com/hdmi-rpi4-b-1m 
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[7] C/C++ setup: https://datasheets.raspberrypi.org/pico/sdk/pico_c_sdk.pdf 


[8] IDE setup script: https://github.com/raspberrypi/pico-setup/blob/master/pico_setup.sh 
[9] RP2040 datasheet: https://datasheets.raspberrypi.org/rp2040/rp2040 datasheet.pdf 
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As far as tests and simple applications go, the displaying of texts 
and values is completely sufficient within the console. However, 
this method has the major disadvantage that a PC or at least a 
laptop is always required. For permanent operation over days 
or weeks, the operation of these devices causes unnecessary 
electricity consumption. In addition, it is not always desirable 
or practical to have a separate computer for each microcon- 
troller application. 


Ifit is only a matter of displaying a time or the measured data from 
climate sensors, then itis much better to connect a dedicated, 
small display to the controller. A widely used device is the 
SSD1306. This display unit has a size of just 0.96 inch (2.4 cm) 
and a resolution of 128 x 64 pixels. 


MicroPython comes with a driver for this display version as 
standard. This driver is already loaded when the file system is 
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This is an excerpt from a chapter in 
Günter Spanner'ss book MicroPython 

for Microcontrollers (Elektor 2021). 

The material reproduced here covers 

the successful union of the popular 

ESP32 microcontroller board with the 
55D1306 OLED using the MicroPython 
programming language. Discover the 
power and ease of use of MicroPython and 
get to programming as well as prototyping 
an ECG display and a digital clock. 


uploaded to the ESP32. The driver enables displaying text and 
numerical data as well as simple graphics. The SSD1306 display is 
equipped with internal RAM and an on-board oscillator. This means 
that it can be operated without additional external components. 
In addition, it has a brightness control with 256 adjustable levels. 


The main features of the SSD1306 display include 

> resolution: 128 x 64 dot matrix; 

> supply voltage: 1.65 V to 3.3 V; 

> operating temperature range: -40 °C to + 85 °C; 

> integrated 128 x 64-bit SRAM display buffer; 

> continuous scroll function in horizontal and vertical 
direction: 

> on-chip oscillator. 


OLED displays do not require backlighting because every single 
pixel in the is able to emit light. For this reason, this variant is 
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Figure 1: SSD1306 display connected to ESP32 microcontroller board. 


easy to read despite unfavourable light conditions. In addition, the 
contrast is significantly higher compared to liquid crystal displays 
(LCDs). Since a pixel only consumes energy when it actually lights 
up, OLED displays are highly energy efficient. 


The simplest versions of SSD1306 boards have only four pins. This 
is sufficient though to control the display via the I?C bus. Other 
variants feature reset pins or an additional SPI interface. For most 
applications, the simple design is adequate though. The following 
table shows all necessary connections. 














OLED Pin ESP32 
VDD 3V3 
GND GND 
SCK GPIO 22 
SDA GPIO 21 





The matching wiring diagram is pictured in Figure 1. The follow- 
ing script outputs atext message and a simple graphic element in 
the form ofa frame on the display: 


# SSD1306 DEMO.py 


from machine import Pin, I2C 
from ssd1306 import SSD1306 I2C 


i2c-I2C(-1,scl-Pin(22),sda-Pin(21)) 

# I2C Pin assignment 

oled_width=128 

oled_height=64 

oled = SSD1306, I2C(oled width, oled height, 
lin hight = 9 

col width = 8 

def text write(text,lin, col): 
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Figure 2: SSD1306 display with text and graphic output. 


oled.text(text,colxcol width,linxlin, hight) 


oled.fill(0) 

text write("MicroPython", 
text write("for", 3, 6) 
text write("ESP32", 5, 5) 


1, 2) 


oled.rect(5, 5, 
oled.show() 


116, 52, 1) 


The resulting display output is shown in Figure 2. Next, to control 
the display, the required modules must be imported. As already 
mentioned, the libraries machine and SSD1306 are normally already 
available as standard libraries. If necessary, however, an ssd1306.py 
file can be uploaded separately to the board. The pin declaration 
for the IC bus is done through: 

i2c = I2C (-1, scl = Pin (22), sda = Pin (21)) 

The number of pixels available in the connected module is defined 
using these variables: 


oled_width = 128 
oled_height = 64 


The parameter ‘-1’ indicates that the module used has neither reset 
nor interrupt pins. With this information, an SSD1306_12C object 
called oted can be created. Here, the previously defined data are 
copied: 


oled = ssd1306.SSD1306 I2C (oled width, oled height, 
TZC) 


The display is now ready for operation. The function text () is used 
to display information on the display is output. With the method 
show() the display is updated. The text () function accepts the 
following arguments: 
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OLED display. 
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Figure 4: Graphic 
elements on the OLED 





Figure 5: Data output on the OLED display. 





display. 

Listing 1: SSD1306 Bitmap Demo. ICON = [ 

(Os. Oy Oy. Oy Ly l, Ly Oy Os. Oy Ol; 
# SSD1306 bitmap, DEMO.py [9, 0, 0, 1, 0, 0, O, 1, 0, 0, 0], 

[0, 0, 1, 0, 0, 0, 0, O, 1, 0, 0], 
from machine import Pin, I2C [9, 1, 0, 0, 0, 0, 0, 0; 0, 1, Ol; 
import ssd1306 [1, 0, 0, 0, 0, 0, 0, O; O; O, 1], 
import urandom [L, d$ ty Ly ty By lp E. iy da Bly 

Os 2, 3. D. L, Ly L, By. 9, D. 91. 
12€ = I2C(-1, sclsPin(22), sdasPin(21)) [9, 0; D, Dy 0, 1, 0, 1, 0; 94 Ols 
oled width = 128 [0, 0, 1, 0, 0, 1, 0, O; 1, 60, 0], 
oled height - 64 [0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 0], 
oled = ssd1306.SSD1306, I2C(oled width, oled height, [9, 0, 0, 9, 1, 1, 1, 0, 0, O; Ol; 

j2c) ] 
for n in range(12): 
# frame xofs - urandom.randint(1, oled width-12) 
oled.hline(0, 0, oled width-1, 1) yofs - urandom.randint(1, oled height-12) 
oled.hline(0, oled height-1, oled width-1, 1) for y, row in enumerate(ICON): 
oled.vline(0, 0, oled height-1, 1) for x, c in enumerate(row): 
oled.vline(oled width-1, 0, oled height, 1) oled.pixel(x*xofs, ytyofs, c) 
oled.show() oled.show() 
Listing 2: Rolling ECG Display. 3.4 
dotPos. old = int(oled height/2) 
& Rolling ECG display.py while True: 
from machine import Pin, ADC, I2C from time import pot value - pot.read() 
sleep voltage = 0.000816*pot value + 0.037822 # 

import ssd1306 print(voltage) 


dotPos. new = int(voltage/vMaxx*xoLled height) 
i2c = I2C(-1, scl-Pin(22), sda-Pin(21)) 


oled width = 128 oled.line(0, dotPos new, 0, dotPos old, 1) 
oled height = 64 oled.scroll(1, 0) 
oled = ssd1306.SSD1306 I2C(oled width, oled_ oled.line(@, dotPos new, ©, dotPos old, 60) 


height, i2c) 
dotPos old = dotPos,. new oled.pixel(0, int(oled_ 
pot = ADC(Pin(34)) height/2), 1) 

pot.atten(ADC.ATTN_11DB) #Full range: 3.3v vMax = oled.show() 
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> message (String type); 
> X-position and Y-position of the text field in pixel units; 
> optional text colour: o = black (dark) and 1 = white (light). 


The following instruction gives a message in white or blue colour 
on dark background out. The text starts at position x = o and y = O: 
oled.text ('MicroPython!', 0, 0) 


The show() method makes the changes visible on the display. The 
library also contains other useful methods. The function fill (1) 
creates a completely white screen, i.e. all pixels are lit. Using oled. 
fill (0) all pixels are set to black or dark. 

The pixel () method allows graphical representations. It accepts 
the following arguments: 


» X-coordinate: pixel position horizontal 
> Y-coordinate: vertical pixel position 
> pixel colour: 0 = black, 1 = white 


A single white pixel in the upper left corner can thus be created: 
oled.pixel (0, 0, 1) 

Now, using: 

oled.invert (True) 


the OLED colours are inverted. White becomes black and vice 
versa. To return to the original colours, oled.invert (False) 
may be used. 


Graphical representations 

In addition to the pixel instructions, other graphic commands are 
also available. Horizontal and vertical lines can be drawn with the 
aid of.hline () or.vline (). The XY start position as well as the 
line length and colour are specified. 


The following little program draws concentric rectangular frames 
on the display, for example. The result is shown in Figure 3. 


# SSD1306 frames.py 
from machine import Pin, I2C 
import ssd1306 


i2c = I2C(-1,scl=Pin(22) ,sda=Pin(21) ) 

oled_width = 128 

oled_height = 64 

oled = ssd1306.SSD1306_I2C(oled_width, oled_height, 
326) 


for pnm [8,5,10,15,20,25]; 

oled.hline(n, n, oled width-1-2x*xn, 1-2x*n) 

oled.hline(n, oled height-1-n, oled width-1-2*n, 
1-2*n) 

oled.vline(n, n, oled_height-1-2*n, 1-2xn) 

oled.vline(oled_width-1-n, n, oled_height-2*n, 1-2*n) 

oled.show() 


Diagonals are drawn using . line (x1, yl, x2, y2, c) between 
two defined points (x1, y1) and (x2, y2). The parameter c controls the 
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Figure 6: An ECG signal on the OLED display. 


colour of the drawn line. For simple graphics bitmaps can be written 
pixel by pixel into the display buffer. The program in Listing 1 
shows a corresponding example, resulting in a display output as 
in Figure 4. 


OLED display as data plotter 

Besides bitmaps, measurement data can be graphically displayed 
on the OLED display. This means you are no longer dependent on 
the plotter function in Thonny (the IDE used fiir MicroPython) but 
can also set up stand-alone devices to give graphic output. The 
software in Listing 2 provides a rolling display as known from 
professional ECG devices in hospitals. 


A potentiometer may be connected to the ADC input 34 for record- 
ing the measured value. After starting the program, the voltage 
values are continuously shown on the display. This works thanks 
to the integrated scroll function. Using the instruction 


oled.scroll(1, 8) 


the entire screen content is moved by one pixel. If you do not want 
to record single pixels but a continuous curve, you have to connect 
the dots with lines. Two variables are necessary for this: 


dotPos old and dotPos new 


These enable a line to be drawn between the current and the last 
measured value. Then the display is shifted by one pixel. Finally, 
the new position is transferred to the buffer memory: 


dotPos old = dotPos new 


andthe game starts all over again. Figure 5 shows an example of 
continuously changing potentiometer values. If you have an ECG 
amplifier, you can also record the electrical signals of the human 
heart in this way. The result is the typical electrocardiogram, as 
known from the intensive care units in hospitals (Figure 6). 
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Figure 7: Digital clock with OLED display. 


Listing 3: ESP32 / SSD1306 Clock in MicroPython. 
# setable_clock.py 


from machine import Pin, I2C 
import time 
from ssd1306 import SSD1306 I2C 


i2c = I2C(-1,scl-Pin(22),sda-Pin(21)) 

oled width-128 

oled height-64 

oled = SSD1306, I2C(oled width,oled height,i2c) 


time_offset=20*3600+00*x60+0 # hh+mm+ss 
lin hight-5 
col_width=8 


def handle interrupt min(pin): 
global time. offset 
time offset-*-60 
time.sleep(.2) 


def handle interrupt hrí(pin): 
global time. offset 
time offset--3600 
time.sleep(.2) 


button, min = Pin(4, Pin.IN) 
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Figure 8: Circuit diagram of the digital clock programmed in MicroPython. 


button min.irq(trigger-Pin.IRQ RISING, 
handler-handle interrupt min) 


button hr - Pin(2, Pin.IN) 
button hr.irq(trigger-Pin.IRQ RISING, 
handler-handle interrupt hr) 


def text write(text, lin, col=0): 
oled.text(text, col*col width, LinxLlin hight) 


def time text(time): 
secs=time%60 
mins=(time//60)%60 
hours=(time/ /3600)%24 
return "{:02d}:{:02d}:{:02d}". 
format (hours,mins,secs) 


def show(): 
oled. fill(0) 
text_write("Current time:",1,2) 
current_text = time_text(current_time) 
text write(current text,6,4) 
oled.rect(10,25,108,16,1) 
oled.show() 


while True: 
current time-time offset-time.time() 
show() 


Digital Clock with OLED Display 

Another useful application for the display is a time display. This 
turns the ESP32 together with the S5D1307 into a practical digital 
clock. The function time() from the time module returns the 
number of seconds since power on or reset of the board. With the 
help of a variable 

time_offset=20*3600+00*60+0 # hh*mm*ss 

a Start time can be specified. In this case, the clock starts at 
20:00:00. Now, the routine time_text(): 

def time_text(time): 

secs=time%60 

mins=(time//60)%60 

hours=(time/ /3600)%24 

return "{:02d}:{:02d}:{:02d}".format(hours,mins, secs) 


converts the consecutive seconds into hours, minutes and seconds, 
i.e. into the usual hh:mm:ss representation, like in Figure 7. The 
clock can be set using two pushbuttons (Ta1 and Ta2) on ports 02 
and 04, connected as pictured in Figure 8. The buttons have 100-nF 
capacitors on their lines for debouncing. The 1-kQ. resistors serve 
as pullups. The corresponding interrupt routines: 

def handle interrupt min(pin): 

global time. offset 

time offset«-60 

time.sleep(.2) 


and 
def handle interrupt hrí(pin): 
global time. offset 


RELATED PRODUCTS 


MicroPython for Microcontrollers 
Projects with uPyCraft-IDE and ESP32 


The Python programming 
language has experienced 
an enormous upswing in 
recent years and several 
single-board systems 
such as the Raspberry 
Pi have contributed to 
its popularity. Several 
single-board systems 
such as the Raspberry Pi 
have contributed to its 
popularity. But Python has 
also found widespread 
use in other areas, such 
as artificial intelligence 
or machine learning. 
Certainly, both Python and the MicroPython variant are good 
candidates for use in SoCs (Systems on Chip) as well. Powerful 
controllers such as the ESP32 from Espressif Systems offer 


Slektor! ks 


MicroPython for 
Microcontrollers 








time_offset+=3600 
time.sleep(.2) 


ensure that each press of the key increases the minutes (60 seconds) 
or hours (3600 seconds) by one. The complete program for the 
digital clock is given in Listing 3. < 

200581-01 


Editorial notes: An English version of the book is available at www.elektor.com. 
The software package with the book is available free of charge from the article 
support page [1]. 


Questions or Comments? 
Do you have questions or comments about this article? 
Contact Elektor at editor@elektor.com. 


Contributors 

Text and illustrations: Dr Günter Spanner 
Editor: Jan Buiting 

Layout: Giel Dols 


— WEB LINK 





[1] Software archive with: MicroPython for Microcontrollers: 
www.elektormagazine.com/200581-01 


excellent performance and Wi-Fi and Bluetooth functionality at 
an affordable price. These features have taken the maker scene 
by storm. Compared to other controllers, the ESP32 has a much 
larger Flash and SRAM memory, and a much higher CPU speed. 
This book leads into the application of the modern one-chip 
systems. Besides the technical background, the main focus is 
on MicroPython itself. After the introduction to the language, the 
acquired programming skills are immediately put into practice. 
The individual projects are suitable both for use in the lab and 
for everyday applications. Besides the actual learning effect, the 
focus is also on the pleasure of building complete and useful 
devices. By using laboratory plug-in boards, circuits of all kinds 
can be realized with little effort, turning the testing of home-made 
devices into an educational pleasure. 


» Buythe book (hard copy): 


www.elektor.com/micropython-for-microcontrollers 


> Buy the e-book: 
www.elektor.com/micropython-for-microcontrollers-pdf 
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12-to-200-V DC/DC 


Converter 


for Valve Amplifiers 


By Ton Giesberts (Elektor) 


Here comes a (relatively) easy to build DC/DC converter for valve 
amplifiers using through-hole components (just one SO-8 IC) with 
galvanically isolated high voltage output. The transformer is self-made, and 
its turns ratio determines the output voltage. Input is a 12-VDC/5-A mains 


adapter, maximum output power 50 W. 


The high-voltage power section of a tube 
amplifier is an important, but also danger- 
ous, part of the circuit. At the input, we have 
— potentially lethal — mains voltage. And at 
the output, we have a high DC voltage that 
can be rather shocking too. 


The most elementary power supply we can 
safely make from mains voltage consists of 
a well-isolated transformer, a rectifier and 
smoothing capacitor. Its output voltage 
depends on the mains voltage, the trans- 
former, the voltage drop across the diode(s), 
the load and resulting ripple voltage. The high 
voltage in tube amplifiers is often created this 
way. Problem is the fixed turns ratio of trans- 
formers commercially available, resulting in 
a voltage being either too low or too high, 
although in many designs this is not really 
an issue. 


In this project, we use a 12-V mains adapter 
and a custom-made DC/DC-converter to step 
the lower voltage up to 200 V. This way a 
direct connection to mains voltage is avoided 
and the lower DC input voltage can also be 
used for the heaters too. 


Here we present an abstract of much more 
extensive — both theoretical and practical — 
information that the designer has compiled on 
the Elektor Labs page of this project. If you are 
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just interested in some basic background and 
building this 12 VDC/200 VDC converter, this 
article provides all the material you need. But 
if you want to know more about the design 
considerations when constructing a push-pull 
DC/DC-converter and the (transformer) 
calculations involved, follow the link at [1]. 


How the DC/DC Converter 
Works 

The schematic of the DC/DC-converter 
is shown in Figure 1. To make this design 
easier to build, through-hole components 
are used for all parts, except for one IC in a 
SO-8 SMD package. This is a primary-side 
push-pull oscillator with dead-time control, 
the UCC28089 (IC1). The drivers at the output 
can sink 1 A and source 0.5 A and are ideal for 
driving MOSFETs. The absence of a control 
loop in the design means there is no insta- 
bility or noise from PWM control. The duty 
cycle is set to maximum, or in other words: 
dead time between switching on either of 
the MOSFETSs (T1 or T2) is set to an absolute 
minimum (see below). This makes the recti- 
fied secondary output voltage almost DC 
and only a small smoothing capacitor is 
needed. The UCC28089 also has over-current 
detection, but the current shutdown thresh- 
old is relatively high, 0.725 V typical. Several 
amperes of current make the power loss in 
the shunt measuring the current through the 


MOSFETS too high and will influence overall 
efficiency considerably. At 5 A, where we set 
the limit for this circuit, this would amount to 
5 A x 0.725 V = 3.625 Watt! The size of the 
shunt resistor must be large and a high-power 
rating is needed, in this case at least a 5 W. At 
12 V, 50 W output power and 86 96 efficiency, 
this would amount to 7 96 efficiency loss. A 
way to reduce this loss in the shunt is to use 
a voltage divider (R3 and R4) from the supply 
voltage to add a small offset to the current 
sense input. 


The oscillator frequency of the UCC28089 
can be adjusted with trimmer P1 from about 
200 kHz to 560 kHz. The switching frequency 
is half of the oscillator frequency, so adjust- 
able from 100 kHz to 280 kHz. According 
to the datasheet the ON-resistance of the 
TK30A06N1 MOSFETs is 15 MQ max. (Vas 
10 V) and almost negligible. This type has a 
very low reverse transfer capacitance of 33 pF 
and fast switching times (t, /t,« 21/28 ns). 
Additionally the input capacitance of 1050 pF 
is lower than most other MOSFETSs with this 
low ON-resistance. At maximum power no 
extra cooling of the transistors is necessary, 
although constant maximum power is not 
advised. 


In a push-pull converter energy is directly 
transferred to the secondary side. When one 






switch is conducting the other one is turned 
off and energy is directly transferred. A short 
time is necessary between switch-over, called 
dead time, to prevent the primary winding to 
be shorted. If both switches were to be turned 
on at the same time the magnetic fields of 
both primary windings would cancel each 
other, resulting in an extremely high current, 
mainly limited by the series resistance of 
primary windings, MOSFETS, shunt, layout 
and the 12 V DC power supply. The shunt 





SPECIFICATIONS 
Supply voltage 9...14 VDC 
Maximum output voltage 350 V 


(higher turns ratio of transformer) 


Efficiency 
25 W output power 8896 
50 W output power 8696 


Switching frequency 
100/150/280 kHz P1 min/mid/max 


resistors will probably burn out, and if the 
short circuit is sustained so will the MOSFETs 
(even at a small overlap!). To protect the 12 V 
supply a 5 A fuse is used. An advantage of a 
push-pull converter is that the peak current 
through the switches is only slightly higher 
than the average load current on the primary 
side (the current the AC adapter has to 
provide). Lower peak currents in the switches 
mean less conduction losses and results in a 
higher efficiency of the converter. 


PROJECT DECODER 


Tags 

power supply, DC/DC-converter, valve 
amplifier, tube amplifier, high voltage, 
through hole, hand-made transformer 
Level 

entry level - intermediate level - expert level 
Time 

approx. 8 hours 

Tools 

soldering tools, small tip for SO-8 soldering 


Cost 
approx 45 € 


No load current 12 VDC 
300/190/120 mA P1 min/mid/max 


A high load will prevent the converter to 
start. This converter was designed for 
valve amplifiers where the load on the 
high voltage is very low at power-up! 


The Transformer 

The trickiest part of this DC/DC converter is 
the transformer; for a first prototype, it must be 
hand-made. At 150 kHz the output power can 
theoretically be more than 170 W when using 
an ETD29 coil former [2] and N97 material, 
but in real life there are copper losses too. 
No airgap is used in the transformer and this 
reduces the number of turns for primary and 
secondary winding, making the construction 
of the transformer even less of an effort. No 


D1..D4=STTH1RO4QRL 





Figure 1: Schematic diagram of the DC/DC-converter. 
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Figure 2a: First secondary layer. 





Figure 2d: First primary winding, note the 
three wires in parallel. 


Figure 2: Constructing the transformer. 


airgap means higher inductance and better 
coupling between windings. You can use the 
same wire for all windings, 0.7 mm wire makes 
it easy to wrap it around the coil former and 
keep track of the number of turns. 


The idea of the circuit is that the turns ratio of 
the transformer determines the output voltage, 
in case of a push-pull converter the ratio of 


Figure 2b: Second secondary layer. 








Figure 2e: First primary, before soldering. 


one primary winding and the secondary. In 
this project two windings with each two turns 
and a single secondary winding (37 turns) are 
used. With a primary voltage of 12 V, a turns 
ratio of 2:37 would theoretically result in a 
secondary voltage of 222 V. Since no trans- 
former is ideal, this ratio will not accurately 
produce the desired output voltage at a specific 
load. Compared to the high output voltage, the 


SOME TRANSFORMER THEORY 


The voltage induced in a coil is according 
to Faraday's law (simplified): 


E=N*B*A/t 


Where: 

E the voltage [V} 

N the number of turns 
B the flux density [T] 
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A the area of the coil [m?] 
Q2 — Ep 


In a push-pull converter the voltages 
applied to the primary windings are 

- almost - square waves. In halve of the 
period the core can be magnetized from 
Bmax to -Bmax per winding, and vice versa. 
The other winding does the opposite, for 


Figure 2f: And the second primary added, 
transformer ready. 


voltage drop across the rectifier and filter is 
negligible. To make alterations of the finished 
transformer feasible, if the deviation of the 
output voltage is more than expected, it is 
logical to start construction with the primary 
windings, insulate them with special tape and 
insulating sleeves. The secondary winding will 
then be the winding on the outside and the 
number of turns can be changed in an early 


the time of the magnetization change 2 * 
Bmax We have for the induced voltage: 
ESN- 2b ae A 2f 


For one of the primary windings we then 
get the following equation: 
Mises es 0 4 Bee A) 


with area A in cm? (hence the 104) 


ABOUT CORE SIZE AND MAXIMUM OUTPUT POWER 


This topic seems to be the most difficult 
part when designing a DC/DC-converter 
using a transformer. If you search the 
internet a lot of information can be found 
about calculating transformers, even 
complete calculators, making it very easy 
to design one. But most sites refrain from 
calculating core size and refer to pretty 
much the same kind of table for all kind 
of different core's and coil formers such 
as Exx, EExx, EFxx, EFDxx, Elxx, ETDXxXx 
and EERxx. 


The tables are usually sorted by 
maximum power achievable, but 
switching frequency is often missing. 

To have an indication how big the core 
must be a formula using the core area 
product W,A, (multiplying core cross- 
section area and window area available 
for windings) can be used. But factors 
like topology constant (depends on type 


test setup. This procedure was used to make 
the first prototype transformer. However, for 
a second prototype a transformer with the 
secondary winding on the inside and both 
primaries on the outside proved to have better 
characteristics than the first one (see [1]) so 
only the second transformer is described here. 


Construction of the Transformer 
To make the transformer easier to reproduce, 
the coil former chosen is the smallest ETD 
version which has a larger core than needed 
for the output power, 60 W or so (at a theoret- 
ical 100 % efficiency). 


Two pins of the coil former are cut off (pin 8 
and 10 according to numbering on the coil 
former of TDK/Epcos) to ensure correct orien- 
tation of the transformer on the PCB. Look 
at the PCB layout to make sure you cut the 
correct pins. Primary and secondary pads are 
well separated on the PCB as are the outputs 
of the secondary winding on the PCB. Origi- 
nally there are 13 pins on a coil former of type 
ETD29, there already is a gap between pins 3 
and 4. One terminal of the secondary winding 
has two possible connections. Depending 
on the number of turns and thickness of 
the copper wire used, the number of layers 
needed can be more than one and the end 
of the winding is either closer to the opposite 
side or at the same side as started from. For 
this reason pins 4, 5, 6 and 9 are connected 


of converter), current density (depends 
on maximum temperature rise permitted) 
and window utilization factor have to 

be entered in the formula(s). But it's not 
an exact calculation, there are too many 
dependencies. 


Many years ago kits for building 
transformers were available from 

Block. One kit contained a small roll 

of insulating film, insulating sleeves, 

2 small card boards for a defined 
airgap, coil former, 2 half cores and 2 
clips. Of course, copper wire had to be 
obtained elsewhere. Also in the box 
was a leaflet called 'Berechnungsbogen 
für Schaltnetzteil-Übertrager EB' 
(Calculation sheet for switched-mode 
power supply transformers). It has 
formulas for calculating minimum core 
size, primary and secondary turns, wire 
diameter for primary and secondary. Core 


on the PCB. Pin 7 is the other terminal of the 
secondary winding. Always start the second- 
ary winding at pin 7. 


Pin 1 and 13 are the connections for the first 
primary winding, pins 2 and 12 are the connec- 
tions for the second primary winding. On the 
PCB names are placed next to the transformer. 
P1/PC for the first primary winding, P2/PC 
for the second primary winding. PC stands 
for common connection of the two primary 
windings. S1 and S2 are the connections for 
the secondary winding. 


Make the secondary winding, starting at 
pin 7, 24 turns were wrapped around the coil 
former (Figure 2a) and insulated with tape. 
Then wrap the second layer with 13 turns to 
complete the 37 turns in total for the second- 
ary winding (Figure 2b). The second connec- 
tion was insulated with a piece of PTFE sleeve, 
as shown in Figure 2c. It would have been 
better to also insulate the first connection of 
the secondary winding (missing in the photos 
of TR2). Then the second secondary layer is 
insulated with tape. Don't heat up the wires 
to the pins of the coil former too long. This 
will melt the plastic of the coil former. That's 
why the wire ends have to be properly tinned 
before wrapping them around the pins! 


Next, the first turn of the first primary winding 
starts at pin 1. Use a sharp knife to remove 


material at that time was N27. Biggest 
difference with present day N97 is relative 
core losses are considerable lower for 
N97, 300 kW/m? instead of 920 kKW/m? 
(at 100 kHz/200 mT/100 ?C). The formula 
to calculate then minimum core size: 


Minimum core size [mm] = 4.7 * 106 * 
Maximum total output power / frequency 
[W/Hz] 


Using this formula to calculate maximum 
power at 150 kHz and a core size of 
5350 mm? is 170 W, that is what | meant 
with the ETD29 core is bigger than 
strictly needed. 

If anyone knows how to derive the 
formula or a similar (better) one and/ 

or give insight how to calculate core 

size more accurately, please share the 
knowledge. 


insulation of every wire and already solder 
this end before wrapping it around a pin. Use 
pliers to squeeze the wire end tight around the 
pin before placing two turns around the coil 
former. Fit the wire, make it (a bit more than) 
long enough, to reach the opposite pin but 
do not connect it yet. Do this for the next two 
turns of this primary winding (three wires are 
connected in parallel, see Figure 2d). Then 
remove the insulation of the three ends. Solder 
the ends first and squeeze all three around the 
pin so the winding is placed optimal (as flat as 
possible and evenly spread, Figure 2e). Repeat 
this procedure for the second primary winding, 
starting at pin 2, see Figure 2f. Figure 3 shows 
the transformer with all windings finished. Don't 
forget to fit the core though! 





Figure 3: View on the finished transformer's pins. 
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COMPONENT LIST 


Resistors 
RIAK 
R2 = 1k5 
ooo Kk 
R4 = Ik 
I5 3622: 
RZR8 = 015 O, 1W 
(Multicomp Pro MCKNP01SJ015KA10) 
R9,R10 = 100 O,1W 
(Multicomp Pro MCKNP013J0101A10) 
R11 = 220k, 1 W, 350V 
P1 = 100 k trimmer, top adjust 


Capacitors 

C= 1500750) cites mm 

C2 = 477 1,50 V; pitch 5 mm 

636409 = 1,50 V, pitch a mim 

C5 Co = 220p 100 V pitch 5mm 

C7 = 220 y, 25 V, 20 96, Polymer Aluminum, 
pitch 3.0 min D 8 mm ESR ES mO 
A750KS227M1EAAE015 Kemet 

C9,C10 = 470 n, 400 V, 5 96, Polypropylene, 
pitch 15 mm (19x9 mm max.) 


Inductors/Transformers 
TR1 = 2x core ETD29, N97, Ungapped, 
B66358G0000X197 TDK/Epcos 


TR1 = Coil former, ETD29, B66359W1013T001, 


TDK/Epcos 


5 


C5 


1 
"^ OELEKTOR 
200307-1 


74 May & June 2021 www.elektormagazine.com 


aC): 


| 


li E 





TRI = 2x clip, B6635952000X000, TDK/Epces 
i= 2:2 Url 10%, 5.6 ARMS; 21m pite 
5 mm, D 8.5 mm max, 
RLB0913-2R2K Bourns 
L2 = Common Mode Choke 500 uH, 1 A, 0.3 O, 
SU9V-10005 Kemet 


Semiconductors 
IDTID2 DS DA S MAIROAORIE 
HIE es SIS) ede] rete 

71,72 = TK30A06N1, TO-220SIS 
ICi= UCC2E089D; SO/C-8 


Other 

K1 = 2-way terminal block, pitch 5.08 mm 

K2 = 2-way terminal block, pitch 768 mm 

F1 = Cartridge fuse, 5x20 mm, 5 A time delay 
with fuse holder for cartridge fuse 5x20mm, 
500V/10A and cover 

TR1 = Electrical Insulation Tape, Polyester Film, 
3M 1350 12 MM 

TR1 = Copper wire, 0.71 mm for all windings, 
49 turns in total, 3 meter 

TR1 = PTFE protective sleeving, internal diam. 
102 mim min; Pro Power bbb 18 CER, 
10 cm 

PCB 200307-1 v11 


S1 S2 


se | [esd 


SA T 2842003A_Y17 
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Building the DC/DC Converter 
The Gerber and drill files for production of the 
PCB (Figure 4) are available for download 
at [3]. Order the PCB from your preferred 
supplier. The PCB in the photos of the proto- 
type Is version 1.0, a small correction was 
made in version 1.1, placing the text "--HV" 
and “0” next to screw terminal K2. 


First, solder IC1 to the PCB, the small SMD 
(SO-8). To save space the 1 W power resis- 
tors (R7-R10) on the primary side are small 
size versions (body 10 mm x 3.5 mm), if you 
have some old stock or buy random types 
they may not fit. Look in the BOM for the 
manufacturers reference of the series we 
used. Also, C7 should be a polymer alumi- 
num type, do not use an ordinary electro- 
lytic version, it will most likely burn out! 
The type listed (A750KS227M1EAAE015 
from Kemet) can handle a ripple current 
of 4.42 A at 100 kHz and has a very low 
series resistance of 15 mQ (100 kHz/20 ?C). 
Mounting the rest of the components is 
pretty straight forward. The resistor for the 
LED (R11) indicating the presence of the 
high voltage (HV) must be at least a 350 V 
type and can be a larger 1 W resistor. Note 
that the circuit doesn't comply with mains 
Class Il specifications! The design of the 
converter has increased clearances, the 
copper plane at the output has an increased 
electrical clearance and also the trans- 
former (if properly constructed) provides an 
excellent galvanically isolated high output 
voltage. Set trimmer P1 to mid position for 
150 kHz switching frequency. 


When using this DC/DC-converter, make 
sure that there are no electrically conduct- 
ing objects close to components that are 
connected to the high voltage. The bigger 
the clearance the better! 


The output voltage can be changed by adjust- 
ing the number of turns of the secondary, but 
also by changing the number of turns of the 
primary windings, if the correct switching 
frequency is respected. Changing C1 (and R2) 
for a different oscillator frequency will change 
dead time! Before changing values, have a 
good look at the formulas in the datasheet 
of the UCC28089, 


Designing push-pull DC/DC-converters and 
- maybe even more — the calculation and 
construction of the "custom-made" trans- 
former needed is quite complicated. As 
mentioned earlier, more background on this 


> M. van der Veen, Vanderveen Trans Tube Amplifiers (Elektor, E-book) 
www.elektor.com/vanderveen-trans-tube-amplifiers-e-book 


> M. van der Veen, Designing Tube Amplifiers (Elektor, E-book) 
www.elektor.com/designing-tube-amplifiers-ebook 


subject is presented on [1], where you can also 
share questions, comments, suggestions and 
experience with these converters or trans- 
former design with other readers. M 


Questions or Comments? 
Do you have questions or comments 
about his article? Email the author at 


200583-01 
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Heat Seeker 





The Seek Shot Pro Thermal Imaging Camera 


By Alfred Rosenkranzer (Germany) 


We recently put a neat thermal camera through its paces to test its usefulness in the lab. 
We found that this pocket-sized camera can quickly track down problems in common 
applications. But the camera is small, so can the display really be big enough to be useful? 


Let's take a closer look. 





Figure 1: Front view showing IR lens, normal lens and LED light source. 


Santa Barbara California-based Seek Thermal has a range of profes- 
sional IR imaging products in its catalogue. The Seek Shot Pro thermal 
camera arrived in a sturdy 173 x 115 x 44 mm cardboard box. Along 
with the camera was a USB cable, a carrying strap and the multilin- 
gual information sheet. 


The camera measures 140 x 80 x 25 mm with a format more like a 
smartphone than a 35 mm camera (Figure 1). The case has a rubber- 
ized surface which feels good in the hand, making it less likely to slip 
from your grasp whilst offering some mechanical protection. The case 
is fitted with just two mechanical pushbuttons: an on/off button and 
a shutter release button for taking stills or videos. All other settings 
are made using the touchscreen. 


A Walk Around 

The camera's USB port is hidden under a flip cover on the bottom. It is 
used to charge the camera's built-in battery and to transfer images to 
a PC. The internal memory cannot be expanded because there is no 
SD card slot. The biggest difference to a smartphone is the 0.25-inch 
female thread for mounting the camera to a standard tripod. 
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Figure 2: Rear view showing active display. 


In Figure 1 you can see a front view. On the front face of the camera 
at the top right corner is the large IR imaging lens. Below it is the 
smaller visible-light lens. To the left of the IR lens is an LED used to 
provide additional flash illumination in low-light conditions. The LED 
can also be switched independently to act as a flashlight if you lose 
your way in the dark. 


There are two versions in the Seek Shot thermal imaging range of 
cameras. The lower-spec version produces a lower resolution IR image 
of 206 x 156 pixels, while the Pro version offers 320 x 240 pixels. This 
may seem modest compared to the pixel density you would normally 
expect from a smartphone camera but IR thermal imaging arrays have 
much lower resolution. For most applications a higher resolution IR 
thermal image would not bring any real advantages. 


The Pro version offers a field of view of 57? which corresponds to 
about 40 mm focal length for a 35 mm camera format. This is a 
little bit wider than the eye's field of view. The budget version of 
the camera has a 36° field of view (= 66 mm for 35 mm format) 
giving it more of a telephoto characteristic. The only difference 


between the two cameras from the outside is the colour of the 
border around the IR lens. In the budget version this is gray while 
on the Pro version it is red. As you can see in Figure 1, | am testing 
the Pro version here. 


First Impressions 
First off, you should plug in the USB cable to charge the camera battery. 
This will give you some time to familiarize yourself with the operating 


image and store the results as required. To capture a single thermal 
or overload event you can take a series of pictures and then study the 
sequence of images later. 


The Display 

After power up, it takes a few seconds until the time and date are 
displayed on the left in the upper bar of the display (see Figure 2). 
The battery charge status is shown on the right. An arrow pointing 





Figure 3: The prototype of an electronic load as a normal image (3a), as a mixed image (3b), a mixed image with three measuring 
points (3c) and a mixed image showing maximum temperature (3d). 


instructions and check out some instructional videos on the company 
web site [1] — at least that's what | did. It's worth getting to know the 
camera and its features before you really need to use it in earnest. 


The camera is largely a point-and-shoot device. Most of the settings are 
automatically assigned so you cannot change the aperture or exposure 
time, and both lenses are fixed-focus so there is no focus adjustment. 
According to its spec, the minimum focal distance is around 10 to 
15 cm. This applies to both lenses so the Seek Fusion image overlay 
works down at this range also. 


For me, one of the most useful features of the system is its ability to 
carry out post analysis of an image and then to store it as a copy in 
the gallery. This allows you to create many different versions of a single 


downwards is shown in the middle of this bar. This gives access to 
the menu where you can adjust things like the screen brightness 
and allows you to set the units (Celsius, Fahrenheit or Kelvin) of the 
displayed temperature. You can also set the emissivity of the surfaces 
to be photographed here. This is important so that the pictures show 
the correct temperatures. 


The flashlight icon on the right can be used to switch on the front 
white LED and a flash icon will activate the LED flash function. The 
Wi-Fi link can be set up or a description of the camera can be called 
up using the integrated help function. A standard cogwheel icon takes 
you to the advanced settings menu where you update the time, date, 
menu language and other configurable features. Returning from the 
menu, the display now looks something like Figure 2. 
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Figure 4: (4a) shows the circuit on the perf board as a fusion view, while (4b) 
is the pure thermal image. 


Along the bottom of the display are four icons. On the left, the landscape 
icon takes you to the image gallery containing pictures that have already 
been stored. These can be recalled and edited. More on that later. The 
second icon from the left opens another menu in which the various 
temperature measurement options can be selected. A click on the left 
cross-hair icon shows the temperature of the surface shown at the centre 
of the active screen. By moving the camera around we can read out the 
temperature but there is a bit of a lag in the temperature display so you 
need a steady hand. The three-point icon shows the spot temperature 
of up to three positions on the image. The icon showing a square with 
dots at the corners creates up to three resizable and repositionable 
regions of interest on the active scene. The camera can then show 
the maximum, minimum, and average temperatures for each of these 
fields. The icon with plus and minus signs on the far right activates the 
measurement of the warmest and coldest point in the image. Take a 
look at the training videos to see how these function work. 


The eye icon opens a menu for changing the view. If the eye icon shown 
as a continuous line is selected, the normal optical image is displayed. 
The eye icon on the right with the broken lines can be selected to 
show the thermal image. The middle image shows both eyes overlaid 
to indicate the Fusion View. One click brings two controls. The left one 
adjusts the image mix between optical and thermal image. With the 
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Figure 5: It’s cold outside with the blind up (5a) and now with the blind 
down (5b), 


right one, both images can be shifted vertically to compensate for the 
parallax error in the vertical plane that becomes more obvious as the 
two lenses in the camera get closer to the object. Tapping on the colour 
icon brings up the colour palette which allows you to apply various 
colour schemes to the active image. Depending on the temperature 
range in the image, a specific palette may be better suited to discrim- 
inating between temperature differences. 


Test Images 

The temperature scale is usually 'autoranging, but can be fixed as 
required so that images can be compared more conveniently. Figure 3a 
shows a normal visual image of an electronic load with its cover 
removed. In Figure 3b we can see an image made up of the visual 
picture with its thermal image superimposed — i.e., the Seek Fusion 
view. The maximum temperature registered in the selected rectan- 
gular zone is 99? C. Along the right hand side of the image we can 
see the temperature colour scale. Figure 3c shows the temperature 
of three selected measurement positions on the heat sink and enclo- 
sure surfaces. In Figure 3d we can show whereabouts in the image 
the maximum temperature is registered. 


In another example in Figure 4a | have built a small test circuit on 
perf board made up of five 100 Q resistors connected in series. The 


first resistor is a conventional through-hole outline while the other 
four are 1206, 0805, 0603 and 0402 SMD outline. A current of 10 mA 
is allowed to pass through the chain. The temperature differences 
between each device are quite small but the thermal image makes it 
more obvious. The narrow temperature range used in this image can 
be seen in Figure 4b. 


It goes without saying that a thermal camera is not only a good aid for 
electronics engineers, it is also a very convenient method to quickly 
identify areas of heat loss and insulation failure in a domestic environ- 
ment. To test it out | went outside and took some pictures. Here in 
Europe, windows are often fitted with external metal roller blinds. I 
took a couple of pictures to show what effect these have in reducing 
heat loss. Figure 5a shows the window with its roller shutter open 
while in Figure 5b it's fully closed. You can see a maximum tempera- 
ture difference of 2? C. 


It goes without saying that whenever we have a camera in hand we 
need to take a selfie or in this case a thermo-selfie. The resolution and 
accuracy of this particular camera model is not suitable for identify- 
ing a fever by measuring skin surface temperature. (Seek Thermal Inc 
does, however, produce specialized equipment for such applications.) 
According to the reading shown in Figure 6, | should be confined to 
bed with a cool drink immediately. The temperature accuracy Is given 
as +2° and is highly dependent on the value of surface emissivity 
which can be set in the menu. 


| took all these pictures only once and then edited them in the gallery 
and then saved them as a copy. To do this, open the gallery by tapping 
the landscape icon, select the correct image with the arrow keys, and 
activate editing. When you are done, you save the picture as a copy. 
In this way, the original is retained for other processing. All of this 
along with live image streaming is also possible remotely via Wi-Fi 
using the corresponding app on a mobile phone or tablet although | 
didn't check that out. An app for the PC, such as is available for other 
thermal cameras, would also be highly desirable. 


Editing on the small screen with my stubby fingers can be a bit frustrat- 
ing and requires a lot of concentration and patience. | mainly use 
this infrared camera to quickly check electronic circuits and found it 
remarkably useful. 


To Sum Up 

A thermal camera in the lab is an excellent tool for debugging problems 
in prototype circuits and detecting overload conditions. It is a far more 
practical approach compared to say, using a thermometer probe or a 
wetted finger. In some instances, it can provide quick indication that 
a component in your latest design project is approaching its dissi- 
pation limit and may even give you enough time to pull the plug and 
ensure that none of the magic smoke is allowed to escape. It is also 
extremely helpful and convenient to be able to take and save thermal 
images for later analysis and evaluation as required. 


The Seek Fusion view which combines normal and thermal images is a 
real help to identify a heat source indicating a failing component or to 
show an area from where heat is escaping from an insulated building 
or enclosure. For general-purpose lab applications, the thermal image 
resolution does not need to be particularly high. With this in mind, I 
would think also (although | didn't get the chance to test it) the lower 








Figure 6: A Thermo Selfie. Hey, I'm hot! 


resolution provided by the budget version of the Seek Shot would 
also be more than sufficient for most lab work. In this review, | chose 
the better and more expensive Pro version. For a little over € 800, the 
Seek Shot Pro does compare well with a similar professional camera 
from Flir, which is around 10 times more expensive (and now more 
than 10 years old), All in all, | found it quite impressive and particularly 
handy for general lab use! I« 
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SOFIWARE 


Oogect- Onentea Programminc 


A Short Primer Using C++ 


By Roland Stiglmayr (Germany) 


Want to write your own high-performance object-oriented programs? First, you must 
familiarize yourself with the advantages of OOP over procedural programming. Let's dive in 
with a little theory and then some practical examples. 


The method of object-oriented programming (OOP) has now 
been around for over 40 years. Among its many benefits are its 
superior quality assurance procedures, easier software mainte- 
nance and excellent structure which helps simplify teamwork in 
program development. In recent years, OOP has also found its way 
into the area of embedded programming. The Arduino IDE also 
supports its use; it seems like a good time to explore the subject 
a little deeper. This article can only give a very rough outline of 
the main features of OOP but will hopefully create a good base 


Listing 1: Class declaration of Virt M (Lesson 1) 


class V1rt M 


of knowledge and experience from where you can go on to write 
your own object-oriented programs. 


When it comes to software development, there are basically two 
different approaches that can be used. The traditional method 
makes use of procedural programming while the alternative uses 
object-oriented programming. Procedural programming is the one 
we have always used (for example, when programming in assem- 
bler or in standard C). Here the program is broken down into small 


i 
private: //the following members are only 
//accessible within the class 
float voltage; //virtual voltage/ V 
float current; //virtual current/ A 
float poresutt: //calculated power/ W 
float r. result; //calculated resistance/ Ohm. 
public: //the following members are also 


//accessible from outside the class 


String s= ("public: Demo attribute s, type String"); 


//for demo only 


// declaration of the constructor, its method is called when an object 


// of this class is created 


Virt M (float v, float cy: 


//declaration of the constructor 


// declaration of the methods/ functions of the class Virt M 


float get P (); 
float get R (); 
float get Voltage (); 
float get Current (); 


//method reads 


//method reads power 
resistance 
//method reads voltage 
//method reads current 


void prep Meas (float v, float c); //method simulates the measurement 


private: 


void set Voltage (float v); 
void set Current (float c); 


//only accessible within the class 


//interface method for writing voltage 
//interface method for writing current 


Le Viend of the class declaration 
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modules (i.e., procedures or functions) and processed sequentially. 
The modules communicate using common, often globally declared 
data and use this to exchange results of their computation. By 
contrast OOP encapsulates the data and the functions that use it 
into objects. Access to data and functions takes place via functions 
provided for this purpose, which are also called interfaces. Encap- 
sulation provides protection for the data from incorrect access. 


So what are the characteristics of OOP? With OOP functional units are 
formed with logically related members such as data and functions. 
The functions are called methods here. If you imagine a data logger, 
for example, then the data acquisition unit with its many measure- 
ment channels, the processing unit and the user interface could each 
be understood as a functional unit. A functional unit can inherit the 
properties of other functional units, so that a modular structure can 
be made up of these basic units. Protection of the data and methods 
is achieved through the principle of encapsulation. 


We can think of such a functional unit as a separate data type called 
a class. The class represents a ‘building regulation’ from which the 
variables are created. The variables are called objects or instances 
of this class. To avoid misunderstandings, you should be aware of 
the difference between a class and an object! Any number of objects 
can be created from a class. Every person working in a company 
could be said to represent an object, each of these objects being 
created from one and the same class. 


Enough of the theory. Let's get into practice now! As always, the 
easiest way to start is with ready-made examples which you can 
tinker with and modify to try out your own ideas. If we can do this 
within a familiar integrated development environment (IDE), then 
it will further save time and flatten the learning curve. For this 
reason, we have used the popular and free Arduino IDE to run our 
examples used here. The integrated compiler is a full-fledged C++ 
compiler and therefore ideally suited for object-oriented program- 
ming. Any Arduino board to which the sketches are uploaded is 
attached to the computer's USB port. Our example programs, called 
Sketches in the Arduino world, are organised as seven ‘lessons’ 
which can be downloaded from the project page [1] for this article. 
Once they are downloaded they can be unzipped and copied into the 
Arduino IDE Sketch folder. Once that's been done the preparations 
are complete. The examples are all based around the concept of a 
virtual measuring device; there is no actual hardware involved it 
just illustrates to processes involved in transferring information. 
The example sketches are not suitable for a 'real' hardware-based 
measuring device, but they show the basic features of OOP very 
nicely using a task that is easy to understand. 


The first class 

To begin with, we will get to know the creation of a class, the 
meaning of the access specifier, the basics of encapsulation and 
the creation of instances. To do this, we will need to load the sketch 
from Lesson 1totheIDE, compile it and then upload it to the board. 
Before we use the serial monitor of the Arduino IDE to view the 
output generated by the program, let's first look at the program's 
source code in Listing 1. 


On the first line we see the descriptor class with the name virt M. 
This tells the compiler that a class with the name virt Misto be 


generated. In the following lines, we can see declarations ofthe inter- 
nal data (or attributes) used in the class and the methods ofthe class. 
For access control the class members, the attributes and methods of 
the class, are assigned with the private and public access specifi- 
ers. Members with private access can only be accessed from within 
the class. Any members with public access can be accessed from 
outside the class. We will see later what this means. 


The first method, which has the same name as the class and provides 
no return value, is the constructor. The constructor is always called 
when an object of the type ofthis class is created. Values are usually 
passed to the constructor to initialize the object attributes. 


Briefly to the other methods: The methods beginning with get 
allow the private attributes of the class to be read. The methods 
beginning with prep. are used to set these attributes. These 
methods are public and thereby establish interfaces to the private 
attributes. The set methods specified as private can only be used 
within the class.. The String sis used to demonstrate the public 
access specifier. The closing curly brace followed by a semicolon 
indicates the end ofthe class declaration. 


Following this are the definitions of the methods that have been 
declared above. This is identical to definitions of functions in 
standard C except for the syntax used. Here the syntax is: 


class name::method name(parameter list) 


The reference to the class is established with the scope reference 
operator, the double colon. 


Our first class is now ready from which we can create objects. Just 
like we did with the function declaration the name of the class is 
made up of the type followed by the name of our objects and (if 
agreed) a list of values to be transferred (Listing 2). When creating 
an object, also called instantiating, the constructor method of the 
class is called and the attributes of this object are created. It is very 
important to be aware that every object has its own, individual data 
part — namely, the attributes. 


No mention has been made of what an object of this class does. 
In this example it simulates the acquisition of measured values 
of voltage and current and makes these invented values available 
together with the resulting values of resistance and power to the 
corresponding methods. The call of a public method is made with: 


Object name.method name(); 


Attributes protected by private can only be accessed using the 
methods provided for this purpose. If you try direct access, the 
compiler returns an error message. This can be demonstrated by 
erasing the appropriate // comment markers in the setup routine 
(Listing 3). 


As a further example for access control, the String s was delib- 
erately declared as public. Attributes declared in this way can be 
accessed directly with Objectname.Attributename. But beware! 
The object does not protect public members against incorrect use 
by the user program. 
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Listing 2: Creating the Instances (Lesson 1) 


// creating instances/ objects of type 
// Mirt M. preset the attributes start values 


Virt M My M1 (220.0,0.5); //creates the object/ instance My M1 by 
// calling the constructor of Virt-M 


Vor E Me RE The) 


//creates the object/ instance My M2 by 


//calling the constructor of Virt_M 


Listing 3: Testing access control (Lesson_1) 


// for testing the access control delete the comment instruction “//” 


JE 


// My M1l.voltage- 0; 

// My M1l.set Voltage(0); 
String str= (My_M1.s); 
Serial.println (My_M1.s); 


The main program changes the read values by using the prep_Meas 
method, which calls the internal set methods. 


The program examples contain helpful comments and a lot of infor- 
mation that should contribute to further understanding. After start- 
ing the application, the setup routine outputs the attributes of the 


Attributes of the Object My M1 
voltage 220.00 

Current 0.50 

Power 110.00 

resistance 440.00 


Attributes of the Object My M2 
10.00 
1.00 
10.00 

Resistance 10.00 


public: Demo attribute s, type String 


El 


[Neue Zeile Y | [9500 Baud Y | 





Figure 1: Output of the setup routine in Lesson 1. 
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//error > attribute is private 
//error > method is private 
//permitted > attribute s is public 


objects and we can view them using the serial monitor (Figure 1). 


A class as a program library 

The concept of libraries in the world of software development is not 
new. You will have already used them if you have any experience of 
coding in standard C. They are used even more extensively in OOP. 
The reason for this is that the code developer does need to know 
the details of the source code of a class in order to make use of it. 
The use of libraries supports the reusability of program parts and 
thereby promotes the concept of modularity in the program design. 


An example of this is given in Lesson_2, which shows the class from 
the first sketch used as a program library. A library item consists 
of two files; the header file (.h) contains the declaration part of the 
class and the source text file (.cpp) the method definition of the 
class. Although not strictly necessary, it’s useful to use the same 
name for both files. In order to display our Virt_M class in the form 
of a library, only the declaration part needs to be transferred to the 
header file and the definition part to the source text file. During 
development it is recommended to save the library files in the 
same directory as the user program. Using the tab function in the 
Arduino IDE helps us with this, 
but more on that later. 


Lesson_2 i 


1//  ---------------------------------------- -- = - + - = 
2\// 

3 // Easy to understand tutorial for creating and applying classes and objects 
4// by using the C++ Compiler (GCC-g++ Compiler) of the Arduino IDE. The 

5 // sample application shows/ demonstrates a virtual measuring device 


7// Lesson 2, 06.07/07.11.20, Sti 
2a 


9// Topic: Generate a library from the class of Lesson 1 with the header 
10 |/7 file Virt_M.h and the source code file Virt_M.cpp 


14| #include "Virt M.h" 


15 //class Virt M from the current directory 


//load the header file containing the 
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Neuer Tab Strg*Umschalt-N. 
; 


re 
Vorheriger Tab Strg+Alt+Links 
Nächster Tab Strg«Alt- Rechts 
Lesson 2 


Virt M.cpp 
Virt M.h 








Figure 2: The Arduino Tab function 
(Lesson 2) 


It is usual to check at the beginning of the header file whether it has 
already been included by the compiler. That situation could occur 
if another header file has already included our header. If that is the 
case then members ofthe same name would be declared multiple 
times. The syntax for the preprocessor to test this is: 


#ifndef Virt_M_h // the symbol Virt_M_h is used to 
// test if the header file was already integrated 
#define Virt_M_h // if the symbol does not yet 
// exist, then define the symbol 


Class sua // now declare the class 
{ sere 2 // end of declaration 
tendif // finish conditional compiling 


The #include "virt M.h" instruction in the source text file 
is used to include the header file. In our example Arduino.h is 
also included. This is necessary because at this point in time the 
compiler does not yet know the standard libraries. With that our 
library is finished. Now to use Virt M class in a user program we 
can use #include "Virt M.h" to load the header file. 


Arduino libraries often provide an instance of their class library 
already. For example in the Wire library Wire is an object of the 
class TwoWire. The object is included using #include <Wire.h>. 


After development is complete, we can save our library files in 
their own directory. For this purpose, Arduino creates the librar- 
ies directory in the sketchbook directory. We can create another 
directory there in which we will save our files. This also works via 
the IDE with Sketch -» Include library -» Add .ZIP library. 


As already mentioned, the tab function of the Arduino IDE is 
very useful when writing multiple files belonging to a project. 
It is activated via the small triangle at the top right edge of the 
window (Figure 2). 


Inheritance — a core concept of OOP 

Once you start delving into OOP it's not long before you come across 
the idea of inheritance. Let's look at the benefits of this concept. 
Inheritance means making the attributes and methods of a base 
class available to an inheriting class. The inheriting class can be 
called a child class, derived class or subclass. The base class is also 
called the parent class or superclass. The child class adds further 
properties to the ones that are inherited which can also be inher- 
ited further. This means that many different derived classes can 
arise from an inheriting class so that the resulting structure is not 
necessarily linear, but branches out as necessary. A relationship 
made up from many branches! 


Lesson 3 shows how we can use inheritance in our task. To make the 
example a little more meaningful, we are using multiplex addresses 
to select the different measurement channels and bind them to the 
objects created. Virt Misthe base class. Here you can see there 
are three constructors with different numbers of parameters. C++ 
generally allows this so-called 'overloading of function definitions 
(i.e., functions using the same name with different numbers and/ 
or different parameter types). In OOP this is known as polymor- 
phism. Note the keyword access specifier is set to protected. This 
sets the accessibility of methods, classes and other members to 


the inheriting class. In our example it indicates that all inheriting 
classes have accessto the set Mux method. 


To show this is permissible the method is defined in the declara- 
tion part (this only really makes sense for very short functions). 
The first child class is Volt. M, which inherits the class Virt_M. 
The syntax for this is: 


class Volt M : public Virt M // class Volt M 
// inherits the class Virt M 


The keyword public ensures that the access control to the members 
of Virt_Mis retained. Volt M provides the sv attribute, the construc- 
torandthe get Unit method to its inherited members. The decla- 
ration ofthe constructor introduces nothing new, but the definition 
does. Here the constructor 2 of Virt Mis called. During instantia- 
tion, the parameters passed to Volt Mare passed on to the Virt M 
class, the start value ini mdirectly via the constructor virt M,the 
multiplex address via the set Mux method of volt M. The defini- 
tion of the constructors is: 


Volt M::Volt M (byte v. mux, float ini m):Virt M 
(ini m) //set ini m via constructor of of class 
// Mirt M 
i set Mux (v mux); } 
//v_mux via set method 


The Amp Mclassis also an inheritance from virt. M. It has a similar 
structure to Volt, M with the difference that the constructor calls 
the constructor 3 from virt. M. The entire transfer of values to 
Virt Mis accomplished without any additional method. It is worth 
noting here that an inheritance can override an inherited method. 


The classes are now fully formulated so that we can create instances 
of them. The objects M1, M2 and M3 of class type Virt_M show the 
call of the overloaded constructor. My, Volt. M and My, Amp. M are 
objects of the inherited classes Volt, M and Amp. M. 


After starting the program, the behavior of our objects can be 
traced and understood using the serial monitor. Invalid accesses 
are deliberately built into the sketch but are initially commented 
out in the example. If we remove the // comment marker, we can 
then recompile and study the error messages that will be gener- 
ated by the compiler. 


We need to be aware that the inheriting objects use the inherited objects 
as ifthey were a part of themselves. However, each object has its own 
individual data set. The relationship is almost like Virt_M‘s code has 
been copied and pasted into Volt. M and Amp, M. The major disadvan- 
tage of that sort of relationship (on top of the additional work and 
more bulky code) would be when any changes are made to virt. M. AII 
other classes that contain Virt M would need to be changed as well. 


A class can be a friend too 

In the last, example we saw that because of encapsulation it is not 
possible to change the multiplex address of an object. However, 
especially when programming close to hardware, it is often desirable 
to have many access options. For example, if we want to address 
all multiplex addresses sequentially, while debugging, we must 
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Listing 4: Class declaration of Virt M with Debug M as 'Friend' Class (Lesson 4) 


class Virt_M 


{ 
friend class Debug_M; 


//the class Debug_M gets 


//access to the private members 


//of Virt_M 
private: 
float value=0; 
byte mux_adr= MUX_INVALID; 


pub lite: 


//internal members of the class 
//virtual measurement value, set to 0 
//mux address for simulation 


//members also accessible from outside 


Virt_M (byte mux, float ini_m); //constructor with initial values 


void set_Value (float val); 
float get Value (); 

byte get Mux (); 

String s="public: Demostring"; 


//method writes the virtual measurement 
//method reads the virtual measurement 
//method reads mux address 

//for demo only 


F; {/end of the class declaration 


Listing 5: Declaration of the structure t_result data type (Lesson_5) 


struct t_result //type for returning data 


it 

byte mux; //mux adress 

String ss //a string 

float val; //measurement value of type float 
- 


Listing 6: Attribute declaration of the Dev M class (Lesson 5) 


class Dev M 


{ 
private: 
Volt M xptr v; 
Amp M xptr a; 
t result result; //for returning data 
const String sP-( "Power/ W co s 
const String sR= ("Resist/ Ohm: "5; 


create an object for each address. Another possibility would be to 
destroy the object after the call and then create it again. Of course, 
we could formulate the base class from the outset so that its access 
is public. However, this would mean foregoing one of the advan- 
tages of OOP, namely providing some level of security for the data. 
Lesson_4 shows us a neat solution to the problem. We inherit the 
base class Virt M to a new class called Debug. M and declare it a 
Friend in the base class. The function of Debug M is identical to 
that of volt. M with the exception that it can also access the private 
members of Virt_M. To change the multiplex address we can use 
the set method in Debug M which is declared as public. Listing 4 
shows the declaration ofa friend class. 


The virt Mclass does not contain a method for setting the multi- 
plex address. Instead, the constructor is passed two values for 
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//pointer to an object of type Volt M 
//pointer to an object of type Amp M 


initializing the class attributes. One of these values is the multi- 
plex address. The parameters are passed when the base class and 
the subclasses are instantiated. 


Once again the output from the Setup routine shows the results 
of our labour. Friend classes are seldom used, although they have 
the advantage that they use existing methods, offer the desired 
functionality while not compromising the security concept of 
encapsulation when used correctly. 


A class accessing a method in another class 

In the last examples, we carried out power and resistance calcula- 
tions in the main program. We read the attributes of Volt M and 
Amp. M via their methods. Now we will do this in a class of their own. 
Lesson 5 defines the new class Dev. M, which accesses methods 


Listing 7: The constructor method of Dev M stores the pointer (Lesson 5) 


// the constructor passes the pointers to the objects of Volt M, Amp M 


DNE E RE 
Dev M::Dev. M (Volt M xptrv, Amp. M xptra) 
t 
ptr_v= ptrv; 
ptr_a= ptra; 
} 


//pointer to Volt_M 
//pointer to Amp M 


Listing 8: Definition of the get Powr method of Dev M (Lesson 5) 


t result Dev M::get Powr () //calculate power 


1 
result.s- sP; //name, unit 
result.val- ptr v -> get Value () * ptr. a -> get Value (); 
return result; //return via type t result 

} 


Listing 9: Instantiating the objects, transferring pointers to the objects (Lesson_5) 


Volt M My Volt 1 (V MUXO, 1.00); 
Volt M My Volt 2 (V MUXI, 2.00); 
Amp. M My. Amp. 1 (A, MUXO, 1.10); 
Amp. M My. Amp. 2 (A, MUX1, 2.10); 


//object of type Volt M 
//object of type Volt M 
//object of type Amp M 
//object of type Amp M 


Dev M My Dev 1 (&My Volt 1, &My Amp 1); //object of type Dev M, passing pointers 
Dev M My Dev 2 (&My Volt 2, &My Amp 2); //object of type Dev M, passing pointers 


ofthe objects of Volt. M and Amp. M . For this when an instance of 
Dev Mis created, pointers to the objects to be called are passed by 
the constructor to Dev. M. 


First, however, we create a structured data type using struct 
consisting of several elements to contain the results. The data type 
has the name t result (Listing 5). Next is the declaration of the 
Dev_M class. Here the pointers ptr_v and ptr_a, which are used 
in the classes Volt, M and Amp. M class, are assigned. The « opera- 
tor indicates that the name following is interpreted as a pointer 
(Listing 6). The constructor method stores the passed pointers 
under the attributes (Listing 7). 


The Dev. M methods can now use the pointers to access the external 
objects. Access is achieved using the pointername -» methodname 
instruction. The -» operator allows access to a method using a 
pointer instead ofthe . (dot) operator (Listing 8). 


In order to be able to create an instance of Dev M, it is necessary 
to initialise new instances of the index classes beforehand. These 
must be ofthe type Volt Mand Amp. M. When instantiating Dev M 
we enter the pointers to these objects in the constructor parameter 
list. Forthis we use the & operator (Listing 9). Asthe output ofthe 
Setup routine in Figure 3 in our application shows method calls of 
the My. Dev, 1 and My. Dev, 2 objects supply all the relevant results. 


Multiple inheritance 

In the previous example, we first had to create two separate 
instances before we could use the methods of Dev. M. There are 
applications where this certainly makes sense, but for us it should 
just primarily introduce the use of pointers to objects. Some may 
question whether base and child classes can simply be inherited 


Access via My Dev 2 
My Dev 2 V-MUX: 0x11 
Voltage/ V: 2.00 

My Dev 2 A-MUX: 0x21 
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Figure 3: Output of the setup routine in Lesson. 5. 
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Listing 10: Explicit reference to a member in the event of ambiguity (Lesson 6) 


t result Dev M::get Volt () 


{ 
result.s= Volt_M::get_Unit (); 


//read the current voltage 


//call the Volt_M method 


result.val- Volt M::get Value (); //call the Virt_M method 


return result; 


j 


Listing 11: Ambiguity of the get Mux method (Lesson 6) 


Serial. print ("My Devo 1, Volt MUX: 0x"), 


Serial. println (My Dev 1.Volt M::get Mux(), HEX); //method of base class 


Serial.print (My_Dev_l.get_Volt().s); 
Serial.println (My Dev 1l.get Volt().val); 
Serial.println (); 


//initial value of instantiation of My Dev 1 


Listing 12: Using own methods to resolve the ambiguity (Lesson 6) 


Serial-print ("My Dev_2, Volt MUX: 0x"); 
Serial.println (My_Dev_2.get_VMux() ,HEX) ; 
Serial.print (My Dev 2.get Volt().s); 
Serial.println (My. Dev 2.get Volt().val); 
Serial.println (); 


by another class. This is exactly what is implemented in Lesson 6 
i.e. multiple inheritance. The two derived classes Volt, M and Amp, M 
are inherited by the base class Dev. M. Because the derived classes 
contain Virt. M, Dev. M has access to members of all classes. 


In order to simply return the complex results of the Dev M methods 
we simply declare the structure data type t. result again. When 
the class is created, the inherited classes are listed (separated by 
commas) after the : operator: 


class Dev, M: public Volt M, public Amp. M 


With the following constructor declaration, the parameters to be 
passed to the inheriting classes are assigned in a parameter list: 


Dev M (byte v x, float i v, byte a x, float i a); 
// the constructor of class Dev M 


The constructor method definition then assigns the parameters to 
the transfer values of the inheriting classes. When instantiating 
Dev. M, the constructor methods of Volt_M and Amp. M are called and 
the parameter attributes of these classes are assigned. 


Dev M::Dev. M (byte v_x, float i. v, byte a. x, float i. a): 
Volt M (v. x, i.v), Amp. M (a x, i. a) {} 


As already mentioned, we can access all attributes and methods of 
the inheriting classes via Dev. M provided the access specification 
allows this. Dev. M provides us with appropriate methods to do this. 
However, a problem arises here: Since the two inherited classes 
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//method of the inherited class 


themselves are derived from the Virt_M class they have methods 
and attributes with the same name. That leads to ambiguities. To 
resolve this we use the scope resolution operator : : to explicitly 
specify which member of which class we mean (Listing 10). 


Our classes are now defined and we can instantiate objects from 
them. In principle, the methods of Dev. Mare completely sufficient 
to write an application. For a better understanding we also create 
more instances of the base class and the derived classes. Since 
a different multiplex address is assigned for each object during 
instantiation, it shows us which object is currently being addressed. 


After we start the application, the serial monitor will show the 
results of the method calls. Execution of the Setup routine is 
interesting. The attributes of the base class are read in different 
ways. By accessing the multiplex address of the My. Dev. 1 object 
the method of the base class will be used. As we noted with the 
method definitions of Dev Mthe problem of ambiguity also arises 
here. To read the multiplex address we need to specify explicitly 
whether we mean the address of the voltage or the current. The 
method is called get. Mux in both cases (Listing 11). We solve the 
problem by specifying the class reference. 


It is of course much clearer and ultimately simpler to provide its 
own method in the child class volt. M and Amp. M (Listing 12). In 
the example these methods are get. VMux and get. AMux respec- 
tively. These are used when reading the attributes of My, Dev 2. 


The sizeof function is used to determine the number of bytes 
in the data fields of our object. The base class reserves 11 bytes 


while classes derived from this use 17 bytes. Since the base class is 
included in every derived class, the derived classes themselves take 
up 6 bytes each. Dev Minherits 17 bytes twice and requires 22 bytes 
itself; altogether that makes 56 data bytes (Figure 4). 


A tasty treat for Arduino fans 

I'm sure there are some Arduino fans who have often wished 
to be able to integrate one of the Arduino methods into their 
program. Maybe you have developed your own display and 
would like to be able to write to it using the really powerful 
print method. As already suggested this can be achieved by 
creating a class that inherits from the Print class. Lesson 7 is 
a sketch showing how it can be done. Our My Print. C class 
inherits all the methods from Print and overwrites the original 
write method, which would normally transfer display data to 
specific hardware. The write method receives a single charac- 
ter from the print(ln) method as an argument, which it then 
transfers to the display via a hardware interface, such as an I*C 
bus. Our example is working without any hardware so the trans- 
ferred characters are written to a string, the content of which 
can viewed in the serial monitor. 


Because the print(ln) methods are overloaded, it almost doesn't 
matter the type of values we can ‘print’. That's it. Now we can use 
printto write characters to our own display. 


It's a wrap 

I hope this article has provided a good grounding in the principles 
of object-oriented programming. We took a look at class libraries 
and how to integrate them into our applications. In the last example 
we showed that inheriting and modifying external classes is not 
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Figure 4: Output of the setup routine in Lesson 6. 


a problem. Even though there is still a lot to learn, the basics for 
writing your own high-performance object-oriented programs 
should now all be in place. 


I hope that you have been convinced of the advantages of OOP 
over procedural programming. The concepts may be difficult to 
understand at first, especially if you are familiar with procedural 
programming. But take courage, you know what they say: practice 
makes perfect! I 

200563-01 





Questions or Comments? 

Do you have any technical questions or comments on this 
article? You can email the author at 1134-715@online.de or 
contact Elektor at edi torgelektor.com. 





[2] C++ Programming: https://en.wikibooks.org/wiki/Subject:C962B962B programming. language 


[3] Lecture of the TU Munich: www.ei.tum.de/fileadmin/tueifei/Idv/Vorlesungen/cpp/CPP-Skript.pdf 
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HomeLab lours 


Home Lab and an Analogue Synthesiser by Kurt Diedrich 


By Kurt Diedrich (Germany) and Eric Bogers (Elektor) 


Around 1964 the first Moog synthesiser [1] made its appearance - an (entirely analogue) 
modular electronic instrument that revolutionised the music world with its sound 
possibilities. The Moog was manufactured in various forms until 1980. 

This synthesiser formed the inspiration for many music projects - including the Elektor 
Formant from 1977, which continues to enjoy a lot of popularity [2]. The home lab of Kurt 
Diedrich, which we visit in this episode, is also the birthplace of a Moog-like synthesiser - 
a project that is under continuous development and is eminently suitable for DIY, not least 
because it uses readily available and affordable components. 





Figure 1: Kurt Diedrich’s electronics lab... 


The name Kurt Diedrich may ring a bell among the somewhat older 
readers - and rightly so. We start by giving the word to Kurt himself: 


"Already during my geology studies (from 1972 to 1980) I noted that I 
found electronics actually much more interesting than geology. I built 
my first synthesiser in 1973 (and many more would follow). My first 
contacts with (the then) Elektuur date back to the same time. My first 
book (about synthesisers) appeared in 1981, published by Frech Verlag [3]. 


After my studies, I initially worked for some time as an assistant at 
the university, until I was offered a job at Elektuur in Beek as an editor 
and designer in 1981. This was the beginning of a fantastic time with 
many great colleagues. There I developed, among other things, a 
CEM-Curtis synthesiser, as well as a large number of circuits in the 
area of measurement technology and music electronics. 


From 1985 I also worked as a designer and writer for Elex — a 
magazine for the beginning electronics enthusiast; until in 1987 
I unfortunately had to leave in the name of cost reductions. After 
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Figure 2: ..who is working here at the latest version of his synthesiser. 


that, I worked as a writer of technical manuals for various compa- 
nies, the last 17 years at HEAD Acoustics in Herzogenrath near 
Aachen. 


After I reached the age of entitlement for the retirement pension, 
I asked myself how I could spend all that free time usefully and 
pleasantly. And then I remembered that I used to build synthe- 
sisers — so, in 2014, I picked up the thread again. My goal is to 
develop well-functioning (read: well-sounding) instruments using 
ordinary, readily available and cheap parts. And I think that I have 
succeeded very well." 


Kurt finds himself in enviable circumstances, in that he has several 
different work places at his disposal. Figure 1 shows his well-organised 
and spacious electronics lab — and in Figure 2 Kurt is working at the 
most recent incarnation of his synthesiser project. Figure 3 shows Kurt's 
office with computer and library, and Figure 4 shows the workshop 
for the more mechanical work. Be honest — this is something to be 
envious of. It would be far outside the scope of this series of articles to 


delve too deeply into the Kurt's synthesiser project. Here we will do with 
a brief (and necessarily incomplete) description of the block diagram 
of the current version (Figure 5), with the understanding that this is 
a project that is in continuous development. 


"Ihe block diagram shows the basic topology of the synthesiser. 
Each green rectangle represents one circuit board. Each circuit 
board in turn contains a single module, with the exception ofthe 
triple VCA board, which also contains the circuits for the noise 
generator and the mixer (because they occupy very little space]. 


An external switching power supply with an output voltage of up 
to 20 VDC is used. This way the dangerous mains voltage remains 
on the outside of the instrument. The required 2 x 12 V is subse- 
quently generated on an internal power supply board using a DC/ 
DC converter (2 x 500 mA). For example, a power brick from an 
obsolete laptop can be used as the external switching power supply, 
provided it has an appropriate output voltage. 


The MIDI converter is brought to life using an Arduino Nano. This 
circuit is not my own design; but I did design the circuit board for it. 


Theretrigger unit is very important for playing legato (this amounts 
to one key being pressed before the previous key is released — 
something that with fast play is practically unavoidable). Without a 
legato functionality, a synthesiser such as this could only be played 
with one finger — and that doesn't sound particularly great. 


The delayed vibrato unit provides a slowly increasing vibrato 
frequency when a key is held down for longer than 1 or 2 seconds. 
This is an interesting effect that gives an unusual charm to some 
pieces of music. The LFO has, among other things, an output for 
a square wave, which leads to interesting sounds. 


Virtuous play does, of course, require a keyboard. This is the only 
part ofthe instrument presented here that has to be purchased ready 
made. The synthesiser has been designed for compatibility with a 
standard MIDI keyboard. The market offers a wide range of cheap 
MIDI keyboards. I use the 'Easy Key 49' model made by SwissSonic. 


Most electronic keyboard instruments (going in their entirety by 
the moniker of ‘keyboards’) have an additional MIDI output that 
can also be used to control the synthesiser described here." 


Questions or Comments? 

Do you have any questions or comments prompted by this 
article? Send an email to the author via subroutine-sy@gmx.de 
or to Elektor via redactie@elektor.com. 


—. WEB LINKS 








Figure 5: Block diagram for the synthesiser. 


This concludes the very succinct description. Anyone who is interested 
in a complete description, including schematics and such, can contact 
Kurt Diedrich directly (see textbox). I 

200681-01 


Contributors 

Text, photos and block diagram: 
Kurt Diedrich 

Editor: Eric Bogers 


Translation to English: 
Arthur de Beun 
Layout: Giel Dols 





[1] Moog synthesiser: https://en.wikipedia.org/wiki/Moog_synthesizer 


[2] Jan Buiting, "Formant Synthesizer,’ Elektor 4/2008: www.elektormagazine.com/magazine/elektor-200804/18762 


[3] Books by Kurt Diedrich: www.subroutine.info/bücher/ 





(Sektor May & June 2021 89 


SOFIWARE 





Java on ine 
Raspberry PI 


Part 1: GPIOs 








By Frank Delporte (Belgium) 


While the Java programming language 
has been around for along time it is still very 







suitable for developing code for modern computing 

platforms such as the Raspberry Pi. To demonstrate its 

capabilities, the first part of this series provides some background on this programming 
language and examines how Java can control and read GPIO pins. 


Short Introduction to Java 

Java is one of those programming languages which has been 
around for a long time. The first version was released in 1995 [1], 
the same year JavaScript, PHP and Qt were born. Python is a little 
older, having had its first release in 1991. While the Java trademark 
has moved from Sun Microsystems to Oracle, the development 
is undertaken as an open-source project that moved to GitHub 
in 2020 [2]. Since 2018, two new releases of Java are provided per 
year resulting in fixes and newly developed features reaching our 
machines more regularly. This also includes improvements target- 
ing embedded platforms such as the Raspberry Pi. 


There seems to be feeling that ‘Java is dead’ but the numerous 
conferences — yes, even though they've all gone virtual during 





Figure 1: The core of the touch-screen drum booth controller. 
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these times of Corona — and Java-related projects are proof that 
the language is still alive and kicking. The main contributors to 
the development of Java is a long list of well-known companies 
including Oracle, Microsoft, SAP Google and others [3]. It is also 
rumored that half of the Microsoft Azure cloud runs on Java! Today, 
Java distributions are available from different open-source (jdk.java. 
net, adoptopenjdk.net) and commercial providers (Azul, BellSoft, 
Oracle, and others). 


Java on the Raspberry Pi?! 

50, wasn't the Raspberry Pi designed to be programmed using 
Python? Maybe yes, but that doesn't mean you can't use other 
languages. And, although this is a Java article, we don't want to 
imply it is preferable over Python, C or any other language! Each 
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Figure 2: Touch-screen interface controlling relay and LED strips. 


project has its own requirements for which a specific language 
could be a perfect match, or where the development team have 
the best knowledge. 


In my case, as a Java developer, I was really interested to under- 
stand if I could apply my knowledge to the Raspberry PI. This came 
about after my first experiment to build a Python-based pong game 
ended unsuccessfully and the user interface proved disappointing. 
Luckily, user interfaces can be generated with JavaFX, an indepen- 
dent project [4, 5] that extends Java with a framework to build GUIs 
(Graphical User Interface). It provides all the typical base compo- 
nents (buttons, labels, tables, charts) and there is a long list of free 
and open-source libraries that further extend this list. 


This is where I found the perfect match for Java with the Raspberry 
Pi as I wanted to build a touch-screen interface for the drum booth of 
my son (Figure 1 and 2). Combined with a relay board, an Arduino 
and some LED strips, this was to form the basis for my experimen- 
tation in a new world of embedded Java programming. 


Getting Prepared 

For the experiments shared in this article you'll need a recent 
Raspberry Pi with an ARMv7 or ARMv8 processor. The older boards 
with an ARMv6 have a different internal layout for which the default 
Java will not work. If you want to use Java on such an ARMv6 board 
there is a solution that uses the Azul Zulu JDK [6]. Also, if you're 
not too keen on typing, all the code examples accompanying this 
series are also available on a GitHub repository [7]. 

Start by preparing an SD card with the ‘Imager’ tool [8] and select 
"Raspberry Pi OS Full (32-bit)" (Figure 3). Once you start your 
Raspberry Pi, open the terminal and type java -versionto check 
that the version is 11. As you will see, OpenJDK is pre-installed in 
this full version of the OS: 


$ java -version 

openjdk version “11.0.9” 2020-10-20 

OpenJDK Runtime Environment (build 
11.0.9*11-post-Raspbian-1debl10ul) 

OpenJDK Server VM (build 11.0.9+11-post-Raspbian- 
ldebi0ul, mixed mode) 


Visual Studio Code 

You can develop, test and execute your Java code on a PC before 
transferring it to the Raspberry Pi when complete. But there is 
another approach: Visual Studio Code [9]. This free IDE (Integrated 
Development Environment) by Microsoft has along list of exten- 
sions to make it the perfect companion for every programming 
project. There is a version available for 32-bit Arm systems (such 
as Raspberry Pi OS) and 64-bit Arm systems (new Raspberry Pi OS, 
which is still a work-in-progress) or even Ubuntu Desktop [10]. 


There is also a "Java Extension Pack" that adds multiple Java exten- 
sions to the IDE to make it a full Java developer IDE (Figure 4)! 


Experimenting with Hello World! 

Let's try our very first Java program on the Raspberry Pi. With Visual 
Studio Code, a text editor, or in the terminal, create a new text file 
named "HelloWorld.java" with this content: 


Raspberry Pi Imager v1.2 - & 


Operating System X 


< Back 
Go back to main menu 


Raspberry Pi OS Lite (32-bit) 

es A port of Debian with no desktop environment 
Released: 2020-08-20 
Online - 0.4 GB download 


Raspberry Pi OS Full (32-bit) 

A port of Debian with desktop and recommended applications 
Released: 2020-08-20 

Cached on your computer 








Figure 3: Raspberry Pi Imager tool — the optimal way to prepare an SD card. 


192.168,0,222 (raspberrypl) - VNC Viewer 





Figure 4: Visual Studio Code can be used on Raspberry Pi and offers a Java 
Extension Pack. 


public class HelloWorld { 
public static void main(String args[]) { 
System.out.println(*Hello World!”) ; 


All our code is part of the class Helloworld that is, by conven- 
tion, the same as the filename. A Java program starts in the public 
static void main(String args[]) method. The only thing we 
do here is print “Hello World!” as the output of the program. 
Because we are using Java 11 we can run this kind of simple program 
without the need to compile the code. In the terminal, inside the 
directory with your Java file, run the command java HelloWorld. 
java to get the following result: 


pi@raspberrypi:~/elektor $ java HelloWorld.java 
Hello World! 


For sure, print() in Python is shorter compared to System. out. 
println() in Java, but let's forgive this as a “youthful sin”. 
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Listing 1: The CPUtemp.java code to read the Raspberry Pi processor temperature [7]. 


import java.io.BufferedReader ; 
import java.io.File; 

import java.io.FileReader; 
import java.util.List; 

import java.util.ArrayList; 


public class CPUTemp { 


private static final String FILE = */sys/class/thermal/thermal, zone0/temp" ; 


private static final List<Integer> values = new ArrayList<>() ; 


pūblic static void main(String] ares) throws InterruptedException { 


while(true) { 
checkTemp(); 
Thread.sleep(1000) ; 


private static void checkTemp() { 


try (BufferedReader br = new BufferedReader (new FileReader(FILE))) { 


int value = Integer.valueOf(br.readLine()); 
values.add(value); 


int total = values.stream().mapToInt(Integer::valueOf).sum(); 


System.out.println(*Now: “ + value 
* * - Average: * * (total / values.size()) 
+ * - Number of measurements: “ + values.size()); 


} catch (Exception ex) { 


System.err.println(“Error during temperature check: “ 


+ ex.getMessage()); 


Reading the CPU Temperature 

A lot of the system values, inputs and outputs, can be accessed 
through the /sys/ directory of the Linux file system. The values 
stored can simply be read as a text file. Let's try to find the tempera- 
ture of the Raspberry Pi processor from one ofthe files in this sys 
directory. The naming in the directory structure is not always very 
clear, nor is it always simple to determine how interpret the values, 
but it's a good starting point to get to know a bit of the Linux system. 
Run the following command: 


$ ls -l /sys/ 

total 0 

drwxr-xr-x 2 root root Dec 2 15:44 block 
Feb 14 2019 bus 

Feb 14 2019 class 
Feb 14 2019 dev 

Feb 14 2019 devices 
Feb 14 2019 firmware 
Jan 1 1970 fs 

Jan 1 1970 kernel 
Feb 14 2019 module 
Dec 15 11:39 power 


drwxr-xr-x 29 root root 
drwxr-xr-x 64 root root 
drwxr-xr-x 4 root root 
drwxr-xr-x 10 root root 
drwxr-xr-x 3 root root 
drwxr-xr-x 8 root root 
drwxr-xr-x 12 root root 


drwxr-xr-x 122 root root 


O O O O oco 8 8 8 © 


drwxr-xr-x 2 root root 
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Figure 5: Fritzing layout (left) for the LEDs and push-button together with a 
photo (right). 


Questions or Comments? 

Do you have questions or comments regarding this article? 
Then contact the author directly via 
javaonraspberrypi(gwebtechie.be or the editor via 
editor@elektor.com. 


It seems we can find a lot of info here! Let's try looking a little more 
deeply at some of these: 


$ cat /sys/firmware/devicetree/base/cpus/cpuqQ0/ 
compatible 

arm,cortex-a/2 

$ cat /sys/class/net/wlan0/address 

dc:a6:32:c5:b7:9d 

$ cat /sys/class/bluetooth/hci0/uevent 

DEVTYPE-host 

$ cat /sys/class/thermal/thermal zone0/temp 

30667 


That last one would really look like a temperature in degrees if 
we were to divide it by 1000! Let's write a simple program to read 
this value every second and calculate the average temperature. 


The code in Listing 1 uses some more Java methods so we need 
to start with multiple imports. The io methods are used to read 
from a sys fileasa text file. The List and ArrayList are used to 
keep a list of all measured values. From the main() method we call 
a separate method checkTemp() to acquire and store the tempera- 
ture to the list. This allows us to keep the code clean as it is a good 
practice to isolate each functionality in its own method. 


As can been seen, Thread. sleep (1000) is used to wait a second 
between each temperature check. Within the method the average 
is calculated by calculating the sum total of the list of values using 
a stream. Streams were introduced in Java 8 and are a very power- 
ful way to work with lists of items. As before, the file name is also 
the name of the class "CPUTemp.java". 


Like before, this is a simple Java class without additional depen- 
dencies, so we can run it without compiling. The output can be 
halted using ‘Ctrl+c’: 


pi@raspberrypi:~/elektor $ java CPUTemp.java 
Now: 36998 - Average: 
Now: 34563 - Average: 
Now: 35537 - Average: 
Now: 36024 - Average: 
Now: 35537 - Average: 


36998 - Number of measurements: 
35780 - Number of measurements: 
35699 - Number of measurements: 
35780 - Number of measurements: 


Om A U N H! 


35731 - Number of measurements: 


Controlling an LED and Reading a Push-Button 
Let's create another single-file Java application that can toggle two 
LEDs and read the state of a button. The wiring scheme is quite 
straightforward — just a very basic circuit to connect two LEDs 
and one button to separate GPIOs. The button needs 3.3 V, not 
5.0 V, so make sure to use the correct power pin! In this setup the 
LEDs are connected to pins BCM 14 and 15, while the push-button 
is connected to BCM 18 (Figure 5). 


Testing at the Terminal 

With the built-in commands in the Raspberry Pi OS we can access 
the GPIOs from the terminal. We use this to test our wiring. Run 
the following commands to configure pin 14 as an output pin (op) 
and place itin its high (dh) or low state (dl). Try the same for the 


other LED (BCM 15): 


$ raspi-gpio set 14 op 
$ raspi-gpio set 14 dh 
$ raspi-gpio set 14 dl 


We can use a similar approach to test the button by configuring the 
pin as an input pin and requesting the state of the input: 


$ raspi-gpio set 18 ip 

$ raspi-gpio get 18 

GPIO 18: level=0 fsel=0 func=INPUT pull=DOWN 
$ raspi-gpio get 18 

GPIO 18: level=1 fsel=0 func=INPUT pull=DOWN 


When the button is pressed, the "level" value changes to 1. 


Doing It in Java 

Now, let's take the same basic approach as we used in “CPUTemp. 
java" and use the terminal commands in a Java program by using 
Runtime.getRuntime().exec(cmd). If we add the Scanner user 
input class we can also acquire the result of the command and 
use it to check the state of the button. This is shown in Listing 2. 


The code uses an Action enum to simplify the command process- 
ing. In its simplest form an enum is just a list of predefined names, 
but in this example we add a value to each name. This is a strong 
plus point for enums as they allow you to make your code much 
more readable while also simplifying it in a lot of cases. As can 
be seen in the doAction method, the Action enum is used asa 
parameter and its value is used to generate the command that 
needs to be executed. 


The comments in the code should make everything clear as this 
is just simple Java to illustrate the use of input and output GPIOs. 
The most complex part is the runcommand method that uses some 
combined methods to execute the command, read the result and 
handle any possible errors. If this is not clear at this moment, no 
worries — it will be once the code is running! 


As this example again doesn't use any third-party dependencies we 
can run it without compiling. The output will show what's going 
on so you should see your LEDs turning on and off at different 
intervals. When the LEDs stop blinking you can press the button 
as it will be checked 10 times at intervals of 1 second. The expected 
output is as follows: 


RELATED PRODUCTS 





> F.Delporte, Getting Started with Java on the Raspberry Pi 
www.elektor.com/19292 


> Raspberry Pi 4 Starter Kit 
www.elektor.com/19427 
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Listing 2: Code for RaspiGpio.java to control LEDs and acquire button state [7]. 


import java.io.IOException; 
import Java.util.Scanner ; 


public class RaspiGpio { 


private static final String LED_1 = “14”; 
private static final String LED_2 = “15”; 
private static final String BUTTON = “18”; 


private enum Action { 

OUTPUT. PIN(*op"), 

INPUT. PIN(*ip?), 

DIGITAL HIGH(*dh?), 

DIGITAL, LOW(*dl?); 

private final String action; 

Action(String action) { 
thas ,action = action; 

j 

String getAction() 1 
return action; 


publieG static void main(String[] args) throws InterruptedException: t 


// Configure the two LEDs as output pins 
doAction(LED_1, Action.OUTPUT_PIN) ; 
doAction(LED 2, Action.OUTPUT_PIN) ; 


// Configure the button as input pin 
doAction(BUTTON, Action. INPUT_PIN) ; 


// Blink the LEDs with different interval 
FOr int i = ©; 1 < 205 Irr) 1 
System out Prine ln Blink. loop: = 3)5 
if (19$ 2 == 0) { 
doAction(LED 1, Action.DIGITAL, HIGH); 
} else { 
doAction(LED_1, Action.DIGITAL_LOW) ; 


$ java RaspiGpio.java 
Executing: raspi-gpio set 14 op 
Executing: raspi-gpio set 15 op 
Executing: raspi-gpio set 18 ip 
Blink loop: 0 

Executing: raspi-gpio set 14 dh 
Executing: raspi-gpio set 15 dh 
Blink loop: 1 

Executing: raspi-gpio set 14 dl 
Executing: raspi-gpio set 15 dl 


Executing: raspi-gpio get 18 
Button check 0: GPIO 18: Level=0 fsel=0 func-INPUT pull-DOWN 


- PUSHED: false 


Button check 3: GPIO 18: Llevel-1 fsel=0 func-INPUT pull-DOWN 
= PUSHED: true 
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Getting Ready for Next Time! 
With some basics under our belts we've managed to cover a bit 
ofan introduction to Java on the Raspberry Pi. Feel free to play 
around with the example code and read-up on the background 
in the links provided to develop your understanding further. 
Hopefully, this will make the next steps in the next article simpler 
as we develop a full Java application and link our GPIOs with 
awebpage. lq 

200617-01 


Contributors 
Idea, Text and Images: 
Frank Delporte 


Editor: Stuart Cording 
Layout: Giel Dols 


if (19$ 3 == 0) { 
doAction(bED92. Action. DIGITAL HIGH); 
} else { 
doAction( LED_2, Action. DIGI TAL_LOwW); 
j 
Thread.sleep(500) ; 
j 
doAction(LED. 1, Action.DIGITAL, LOW); 
doAction(LED. 2, Action.DIGITAL, LOW); 


// Read the button state 10 times 
for (int = 0; J< 10, Jri) { 
String result = runCommand(“raspi-gpio get “ + BUTTON); 
System.out.println(“Button check “ + j 
P esUt 
+ “ = PUSHED: “ + (result.contains(“level=1”))); 
Thread.sleep(1000); 


Private static void doAction(Strīing pin, Accion action) { 
rúunCommand( raspi- gpio set * + pin t © 4 


action.getAction().toLowerCase()); 


private static String runCommand(String cmd) { 
System.out.println(“Executing: “ + cmd); 
Scanner s = null; 
try q 
s = new Scanner(Runtime.getRuntime().exec(cmd).getInputStream()) 
.useDelimiter(“\\A”); 


return s.hasNext() ? s.next() : “7; 

Prcauch (Exception ex) i 
System.err.println(“Error during command: “ + ex.getMessage()); 
ise 

} finally { 


Th (s l= mull) t 
s.close(); 


WEB LINKS 





Andrew Binstock, ‘Java's 20 Years Of Innovation; Forbes: http://bit.ly/3qelpVu 
OpenJDK project: https://github.com/openjdk 


Liam Tung, Oracle: 'Programming language Java 14 is out with these 16 major feature improvements; ZDNet: 
http://zd.net/35wVW20 


OpenJFX project: https://github.com/openjfx 

OpenJFX: https://openjfx.io/ 

Frank Delporte, ‘How to install and use Java 11 and JavaFX 11 on Raspberry Pi boards with ARMV6 processor’: http://bit.ly/35yRrFc 
Accompanying code examples on GitHub: http://bit.ly/3i9bP4v 

Raspberry Pi Imager tool: http://bit.ly/3i58seU 

Frank Delporte, ‘Visual Studio Code on the Raspberry Pi (with 32 and 64-bit OS)’: http://bit.ly/3qeh9GN 

Visual Studio Code downloads for Arm: http://bit.|ly/2L qUng3 
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PECULIAR PARTS 





DIP Switches 


Peculiar Parts, the series 


By David Ashton (Australia) 


Wait a minute. DIP switches — how can they 
be peculiar? After all, they're just switches! 
Well, it turns out that there are some very 
peculiar DIP switches around. Here we 
present a few from my collection in order of 
increasing peculiarity. 


DIP for the uninitiated, means Dual Inline Package, indicating 
that the pins are arranged in two parallel rows like ICs. Most have 
the usual 0.3 inch spacing (like ICs), but some are 0.2 inches. 
DIP switches are used for setting options, features, addresses, or 
anything else that requires a robust, rarely-used configuration 
capability. Most of the ones you find are 8-way but there are many 
different types, as we will see. 
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Figure 1: A collection of typical DIP switches. 
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First, as a reference point, let's look at the standard DIP switches 
we all know. A group portrait of a few I have in my collection is 
shown in Figure 1. They come in many colours and enliven other- 
wise dull PCBs. 


Some have recessed rocker-type actuators, which means you 
have to hunt around for a paper clip or (worse) a pen, or (an 





Figure 2: Piano-style DIP switches are easier to set. 





Figure 3: Dual and changeover types. 


absolute no-no) a pencil. Others have the actuator standing 
proud of the body so, at a pinch, you could use your fingernail 
to change them. Some, like the one on the right, have colour 
coded actuators. If you know your resistor colour code they are 
easy to read and set. 


Some are mounted vertically with the switches on the side 
(Figure 2). This is useful for making them accessible on back 
panels of equipment. Such ‘piano key’ types make it a little easier 
to change the settings with your fingernail. 


Now we start getting a bit more obscure. There are dual types 
(Figure 3a) where actuating them changes two indepen- 
dent switches at once. There are also changeover DIP switches 
(Figure 3b). The smaller ones have two changeover switches (i.e. 
double-pole, double-throw) and the larger ones have four or more 
changeover switches. This makes them useful for switching atten- 
uators in and out, for example. 


I also have some selector switches (Figure 4). You select one of 
eight or ten pairs of contacts. The blue ones on the left have a cover 
(removed on the lower one) and need a small screwdriver to rotate 
the actuator to one of 10 positions. So, if yu common up one row of 
contacts (which is already done for you in some of these switches) 
you could use them to select one output of a CD4017 counter IC 
for a synthesizer or alarm system. 


You can also find decimal and hexadecimal DIP switches (Figure 5). 
These are used when you need to preset a binary or BCD code, 
often for an address on a board. This is much easier than mentally 
converting a number to BCD or Hex. They are very compact and 





usually have a common line and 4 binary- or BCD-coded lines. 
These come in horizontal, vertical or angled formats. 


In Figure 6a we find a single-pole, single-throw switch. I hesitated 
to include it as it is fairly large and not the standard spacing, but 
they beat jumpers (which never seem to be there when you need 
them!). Then there are the types shown in Figure 6b. They use 
springy wire links instead of being true switches, but they do the 
same job and are easy to use. And, they'd probably carry a fair bit 
more current than the tiny switches usually used. 


Lastly, there is the monster in Figure 7. 16 ways and each switch 
has 3 positions (common to contact 1, off, or common to contact 
2). You could use these to define a bit as 1, O or don't care. Perhaps 
it could be of use in a logic analyser? 


Remote controls often use this type of switch. Having 3 positions 
for each switch considerably increases the number of possible 
codes — 38 (6561) vs 28 (256) for an 8-way switch. M 

200716-01 


Questions or Comments? 
Do you have technical questions or comments about this 
article? Email Elektor at editor@elektor.com. 





Figure 4: ‘One-of-’ style DIP switches. 
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Figure 6: One-way and robust, springy-wire links. 


Figure 5: Hex and BCD switches. 
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Figure 7: A three-way 0/1/don’t care DIP switch. 
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INTERACTIVE 





Project 20 


Corrections, Updates and Readers Letters 


Compiled by Jens Nickel (Elektor) 


LN Simple Function Generator 

Elektor Magazine 07-08/2020, p. 20 (160548) 

RJ An error was made in the circuit diagram: Pot P3 should be wired between the output pin 6 and input pin 2 of ICA, not 
between pins 2 and 7. IC4 works as a buffer for the open-collector output signal from LM311 and P3 controls the output 

signal level (Amplitude). 





Elektor Uno R4 
Elektor Magazine 07-08/2016, p. 98 (150790) 


(2 


The ATmega328PB is now fully supported by the Arduino IDE's default AVR toolchain. This makes installation of the 
Elektor Uno R4 much faster as there is no longer a special toolchain to download. It makes the board also future proof 
as new toolchain features are used automatically. To install the Elektor Uno R4, paste the link 
https://github.com/ElektorLabs/Arduino/releases/download/v1.0.1/package elektor uno r4 1 8 x index.Json 


in the Additional Boards Manager URLs box of the IDE's Preferences window. In the Boards Manager (Arduino IDE menu Tools -» 
Boards -> Boards Manager) filter on 'R4' and make sure the version is set to ‘2.0.0! This has been tested with Arduino IDE version 1.8.13. 


Analogue Filter Design (3) 
Elektor Magazine 01-02/2021, p. 74 (200522) 


« > 

KL | read the informative article by Alfred Rosenkranzer with great interest. It struck me that there is a particular filter 
configuration that was not covered in the article. It has excellent properties, especially with regard to the achievable 
wide selectivity. 


| have been working on the design of an SDR for our Charly 25 project, which uses a STEMIab 16 Red Pitaya unit as the SDR core in 
a TRX design. We used more or less acceptable bandpass filters as preselectors for the front end. Standard bandpass filters proved 
to be relatively poor with regard to the achievable out of band rejection. 


Our goal was to achieve > 80 dB to 100 MHz; this is 

necessary because the A/D converter is very noisy 

and a sensitive receiver typically requires a switch- H+ — WH — W+ — WH: — 
able wide band pre amp which in our case offers | 
+36 dB gain. 


In our search for a better filter structure, we came 

across the 'tubular filter' configuration which is 

mainly used for microwave applications. This type of filter is characterized as a series of capacitively-coupled pi networks (1). 
Unfortunately, this filter type has been largely ignored by the usual free circuit simulation programs - the expensive commercial pro- 
grams for simulating microwave circuits were of course not available to us. The first filter structures were therefore created through 
simulation and step-by-step adaptation using the Elsie filter-simulation software. One of our team members later took pity on us and 
wrote a small program to help calculate this type of filter: 


https://charly25-sdr.github.io/hardware/rx-filters-v2/calculator 


In addition, | eventually managed to find a free program LC Filter Design Tool that also models this type of filter (see Tubular Filter): 
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Charly 25 High Performance Preselector 
https://rf-tools.com/Ic-filter/ 100KHz — 100MHz — example 80m Band 


The results of all our efforts is a pre-selector board suitable for 
use with the 11 amateur bands from 160 to 6 m (plus an unfiltered 
throughput for reception of radio broadcasts) which more than 
exceeds our requirements in regard to selectivity (2). 





It's worth pointing out that the performance of this board was 
achieved by careful component layout on a 4-layer circuit board, 
the earth plane configuration is extremely critical. A simpler lay- 
out using a 2-layer PCB can achieve around 70 dB out of band 
attenuation. 


The complete pre-selector board can be seen in 3. It is controlled 
via an I?C bus which makes it compatible for use with the majority 
of controllers used for receiver projects. To get more information 
on the board go to: 








www.smartradioconcepts.com. 
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For the coil construction it was clear that iron-powder cores are iG ii a T i r] a a T n [| i ii 
most suited for this application and guarantee low intermodula- 


tion distortion. 


T Lb 
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The filter board does not use PIN diodes for RF switching, here 
again the possibility of signal intermodulation effects was too great; 
hence the large number of relays. 


Edwin Richter (DC9OE) 





Poor Satellite Reception with a Sting in the Tail 
À e, f | am currently enjoying some (well-deserved) down-time relaxing in the warmth of the Brazilian state of Bahia. It may 
N be famous as the birthplace of samba but life is never so simple and sometimes | need to don my thinking cap when 
technological problems arise. Recently we noticed something odd about our satellite TV (still analogue) reception. Every 
evening at about sunset the signal became noisy and some channels could not be selected. In the morning everything 
returned to normal with no problems. 


Now | know from terrestrial broadcasting that atmospheric disturbances can occur at sundown but in the decimeter range and with 
a more or less direct view that seemed unlikely to me. So | got in touch with our local satellite engineer who had installed the dish 
a few years ago. 


It didn't take him long; he climbed onto the roof and replaced the corroded LNB. The plastic cap which clips over the LNB input 
throat had gone brittle and partly fallen away (most probably degraded by solar UV and IR exposure). He also found evidence of 
some pest infestation... it seems as though some wasps (bigger than the European varieties) had built a cozy nest in the LNB. The 
installer had seen this before and said that since the last few nights were quite cool (20? C) and the LNBs heat up during the day, 
those pesky little varmints fly off in the morning and return at sunset, where they make themselves comfortable and block the signal 
path. Problem solved — for the equivalent of around €15! 


Wolfgang Meyer 


Questions or Comments? 
If you have any comments or questions please let us know. You 


can reach us by email at editor@elektor.com. 
200715-01 
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Whose Product Is It Anyway? 


Right to Repair Gains Momentum 


By Tessel Renzenbrink (The Netherlands) 


The right to repair movement stands for peoples’ right to fix and 

modify their own products. There are many benefits to repairing items 
instead of replacing them. It saves energy, resources and money and, 

on top of that, it reduces waste. On top, there are few chores more 
satisfying than restoring broken things to their original working state. 
Legislative bodies all over Europe are working on regulations to improve 
repairability. The most powerful of these is a resolution adopted by the 
European Parliament for a comprehensive approach to ensure the right 
to repair. It proposes a long list of measures ranging from extending 
warranties to mandating the availability of replacement parts. 


Planned Obsolescence 

Most EU citizens would prefer to repair, rather than replace, products, 
according to a 2018 study issued by the European Commission [1]. 
Based on behavioral experiments, researchers found that 62% to 
83% of people chose the repair option over buying something new 
(depending on the product type). Citizens are quite ready to trade in 
the throwaway economy in exchange for more durable and repairable 
products. But multiple obstacles make it hard to follow through on that 
choice. Perhaps the most brazen of these is planned obsolescence: 
the practice of purposefully adding frailties to a design to render a 
product obsolete at a predetermined time. In digital devices, planned 
obsolescence can take the form of ending software or security updates 
after only one or two years. The device becomes useless even though 
the hardware is still fully functional. 


Another obstacle is the prevention of repair. Prevention includes designs 
that make it nearly impossible to replace parts. The famous iFixit Smart- 
phone Repairability Scores list evils as diverse as glued-down covers and 
hard-to-reach batteries [2]. Lack of available spare parts, or making them 
prohibitevly expensive, also falls under this category. Another preven- 
tion strategy is declaring the manual as intellectual property, prohib- 
iting consumers and independent repair shops from obtaining them. 


Repairability Index 

Lack of information is yet another hurdle that makes it harder for 
people to opt for repairable products. The 2018 study found that, when 
information about reparability is provided at the point of purchase, 
consumers are "more than two times more likely to choose products 
with the highest reparability ratings’ The French Ministry of Ecological 
Transition is remedying this lack of information with the introduction 
of a repairability index [3]. Much like the iFixit Score, products will be 
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Image by Jose Conejo Saenz via Pixabay.com. Pixabay license. 


labelled with a Repairability Index ranging from 1 to 10. The Index is 
based on five criteria, including ease of disassembly and availability 
of spare parts. Labelling is mandatory for TVs, washing machines, 
laptops, phones and lawnmowers since January of this year. Over 
time, more product categories will be added. The Ministery's goal is to 
have a 60 percent repair rate for electronic products in five years time. 


Right to Repair for European Citizens 

The Repairability Index may come to all EU countries in due course. In 
November 2020, the European Parliament voted in favour of a resolu- 
tion that calls for a more sustainable single market [4]. It explicitly calls 


for a right to repair for European citizens and proposes a long list of 
measures. These include ensuring the availability of manuals free of 
charge, encouraging the standardisation of spare parts for interop- 
erability, setting a mandatory minimum period for the provision of 
spare parts, and providing the parts at a reasonable price. To tackle 
the information asymmetry, vendors should provide information about 
the repairability and durability of products at the time of purchase. 
This includes the availability of spare parts and software updates. 
The Repairability Index is proposed as a means to achieve that end. 


To stamp out planned obsolescence, the Parliament proposes a broad 
strategy. The practice of deliberately adding frailties to a design should 
be banned, and software updates must be provided throughout a 
product's estimated lifespan. To boost consumer confidence in second- 
hand and refurbished goods, warranties should become transferable. 
Rather than linking a warranty to a person, it should be linked to the 





product itself. To create a level playing field for European businesses 
that have to comply with these stringent requirements, the Parliament 
urges the Commission and Member States to put more effort into 
keeping imported non-compliant goods off the shelves. 


Transforming the Throwaway Economy 

The Parliament is not the only EU body calling for a right to repair. In 
March 2020, the European Commission adopted the Circular Economy 
Action Plan that also explicitly named the right to repair [5]. Both the 
Parliament and the Commission call for repair rights to be part of the 
European Green Deal initiative, the action plan to make Europe climate 
neutral by 2050. The ambition is to transform the current take-make- 
use-discard economy into a sustainable, circular economy. Facilitat- 
ing repairs to extend the life-cycle of products fits that ambition. A 
sustainable economy is not only more ecologically balanced but also 
more resilient. In its resolution, the Parliament points out that the 
Covid-19 crisis has made it clear that the current economic system, 
with its global supply chains, is a fragile one. It, therefore, calls for new 
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Citizens are quite ready to trade in the throwaway economy in 
exchange for more durable and repairable products. 





Image by Wilfried Pohnke via Pixabay.com. Pixabay license. 





business models and support for small- and medium-sized European 
businesses. A focus on repairing locally rather than have new goods 
shipped in from overseas would contribute to the development of 
knowledge, skills and local economies. 


The initiatives still have to go through the machinations of the EU legis- 
lative process before becoming law, and they could still be watered 
down along the way. But the fact that the right to repair is embedded 
in the European Union's Green Deal, one of the top priorities on the 
EU's agenda, is very promising. M 

200713-01 


Questions or Comments? 

Do you have questions or comments regarding this article? 
Then get in touch with the Elektor editorial team at 
editor@elektor.com. 





[1] Dr. Annette Cerulli-Harms et al., Behavioural Study on Consumers’ Engagement in the Circular Economy; Page 11, October 2018: 


https://bit.ly/39PVWkA 
[2] Smartphone Repairability Scores, Ifixit: http://bit.ly/2M8yZfJ 


[3] Ministry of Ecological Transition, ‘The anti-waste law for a circular economy: key measures, January 2021: http://bit.ly/3sHioAi 


[4] European Parliament, ‘European Parliament resolution of 25 November 2020 Towards a more sustainable single market for 


business and consumers": http://bit.ly/2NeJcaL 


[5] European Commission, ‘Changing how we produce and consume: New Circular Economy Action Plan shows the way to a 
climate-neutral, competitive economy of empowered consumers; March 2020: http://bit.ly/395SdeE 
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The Great Book of Blunders 


By Ilse Joostens (Belgium) 


From Life's Experience 


The life of the electronics enthusiast is not always plain sailing, irrespective of whether 

you are a beginning hobbyist or a dyed-in-the-wool old hand. Whether you like it or not, 
technology continues to evolve at a great pace, which means you have to keep on learning, if 
you want to keep up with the latest developments. Learning is a process of falling and getting 
up, and the most important things are usually learned the ‘hard’ way, after which you will 
inevitably have feelings of disappointment, failure, and especially great shame. Unless you 
belong to the ‘pamper generation  - sometimes also called the amusement park generation 
- you will only improve yourself from this experience, because you can learn the most from 
your own mistakes. And if it has really gotten out of hand, then there is always the option of 
mustering your best management skills and trying to blame someone else. 


Falling Knives and Pyrotechnics 

When I was still young, sometime during the eighties ofthe previous 
century, there was, compared to these days, relatively little infor- 
mation about electronics available. Computers were not common 
and the Internet still had to be born. I therefore had to mostly 
make do with an old book about electronics principles and some 
obscure little books that I found here and there. The number of 
books about electronics in the local library were also relatively 
limited and data books at the time were only available to compa- 
nies and their stern-looking, grey-bearded electronics engineers 
in their lab coats. 


At some particular time, I was cheerfully experimenting witha 
few diodes, lamps and a model railway transformer. By revers- 
ing the polarity or by using AC I could control two sets of lamps 
independently of each other using only two wires, until I (of course] 
had the ill-fated idea of trying this also with mains voltage. For 
my first test I had built a small bridge rectifier followed by a small 
light bulb. I can remember very well that I saw the lamp light up 
for a fraction of a second before the bridge rectifier blew up in my 
face with a loud bang and a bright flash, like a fireworks cracker 
with a shower of sparks. What did I know that diodes had a certain 
maximum blocking voltage? And that in this case I had exceeded 
this by a wide margin. The main circuit breaker was tripped and 
then I won't mention the panic in the eyes of my housemates. 


A year or so later, I bought my first soldering iron, one of those 
a bakelite stove pokers from the local DIY store. My first solder 
connections were rather ‘lumpy’ looking, but I was happy that Ino 
longer needed to improvise to make connections. In those days, 
record players with a built-in amplifier were popular and at some 
time I committed myself to repairing the record player of a girl 


102 May & June 2021 www.elektormagazine.com 


living nearby. Somewhere inside there was a loose wire. I did not 
have alot of space, and when I was nearly finished, the soldering 
iron slipped off the table, which I then tried to catch in a reflex, of 
course by grabbing the hot end... Analogous with the well-known 
piece of wisdom “Never attempt to catch a falling knife”, I experi- 
enced to my detriment and disgrace that this is also true for hot 
things such as soldering irons. The result was the smell of burnt 
flesh and a substantial burn on my right hand. I did, fighting off 
the pain, complete the job while I grabbed anything that felt even 
only slightly cold to ease the pain, including a set of alkaline D-size 
batteries that happened to lay about and that I held in my hand 
one ata time. A few weeks later there were again problems with 
the record player and someone else had taken a look at it, after 
which I was asked the question as to why I had put a battery in 
the record player... 


We used to have an old-fashioned drill lying around that did not 
have a speed control and the ‘Drill speed controller’ from the 302 
Circuits book from Elektor looked like a great idea. At the time, I 
was already etching circuit boards myself, using a pen with etch-re- 
sistant ink and the entire thing was built quite quickly and tested 
out successfully. Unfortunately, due to a lack of financial means, I 
frequently used ‘recycled’ components of dubious origin. When I 
used it some time later, one of the capacitors failed and instantly 
filled the entire workroom with an awful smelling smoke. Once 
the smoke had cleared somewhat and I made the naughty capac- 
itor with smoke bomb aspirations harmless, the thing continued 
to give faithful service for many years. 


Deceptive Simplicity 
As a professional too, I have an extensive track record of incidents, 
but the space allowed for this article is unfortunately too limited 


to cover them all. I won't therefore elaborate too much about that 
time when I had one phone call after another from customers and 
that, drowsy from all the talking, I cut the power cord to a device 
without first pulling the plug from the socket, after which a large 
part ofthe company was plunged into darkness. Or that time thatI 
drilled into my hand with a drill press... Or that time that I — again, 
drowsy from too much talking — came into contact with both the 
phase and neutral conductors of the mains voltage, whereupon 
the severe electric shock and also especially the reaction to the 
shock sent me flying two metres, desk chair and all, with a rough 
landing against a filing cabinet. 


And even now the apparently simplest things are exactly those 
things that trip me up. Placing an IC with more than a hundred pins 
when designing the circuit board is a piece of cake, but getting that 
connector with only a few pins the right way around the first time, 
forget it! Well, the polarity of things will be forever my nemesis... 


Before I finish, I would like to call on you to share your personal 
blunders and embarrassing moments with the Elektor Commu- 
nity by leaving a comment to this article. There is nothing to be 
ashamed of... Well yes, perhaps only a little bit, but malicious delight 
is also delight. 
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Questions or Comments? 

Do you have any technical questions or comments about this 
article? Send an email to the author or to the editor of Elektor 
via editor@elektor.com. 


Contributors 

Text and choice of illustration: 
Ilse Joostens 

Editor: Eric Bogers 


Translation to English: 
Arthur de Beun 
Layout: Giel Dols 


—— WEB LINKS 





[1] The Pampers Generation: https://bit.ly/2LWJ)QZW 


[2] ElectroBOOM Funny Compilation: 
www.youtube.com/watch?v=gAnBc4iFCvk 


[3] ElectroBOOM YouTube Channel: 
www.youtube.com/c/Electroboom/featured 
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Micro-Professor 


Learning Assembly Language on a Z80 







"P 


In an industry sector that is progressing as 
rapidly as electronics, equally fast continu- 
ing education is the only way to avoid being 
quickly left behind. This was recognised by 
Stan Shih, his spouse Carolyn Yeh and five 
other business associates, who founded the 
company Multitech in Taipei (Taiwan) in 
1976 — now better known under the name 
‘Acer’. Along with distributing spare parts 
for electronic devices and consulting on 
microprocessors, Multitech manufactured 
microprocessor learning systems in their 
own production plants. They therefore 
had prior experience with microprocessor 
learning systems when the Micro-Profes- 
sor MPF-1 (Figure 1) was launched in 1981. 


The Hardware 

The MPF-1 was a single-board computer 
with a six-digit seven-segment display 
and a keyboard with 36 keys. It was built 
around a Zilog Z80 microprocessor 
clocked at 1.79 MHz. Figure 2 shows the 
board layout. The Z80 microprocessor was 
accompanied by a Z80 PIO IC, a CTC IC, an 
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By Karl-Ludwig Butte (Germany) 


In 1981, there were lots of books 
about the Zilog Z80 microprocessor, 
which was introduced in 1976, but 
this particular book was different. 
With its spine width of 4 cm, you 
would anticipate around 500 pages 
of concentrated information, 
leading to many hours of tedious 
study of complicated and highly 
abstract material. But opening the 


book revealed a wonderful surprise: 
instead of the expected indigestible 
microprocessor documentation, what you saw was the microprocessor itself, mounted 

on a board and ready to use. Like to know more? Join me on a journey of discovery of how 
advanced training worked in 1981 with the Multitech Micro-Professor MPF-1. 


8255 IC, 2 KB of RAM and 4 KB of EPROM. 
The 8255, a programmable parallel I/O 
component, connected the keyboard and 





Figure 1: The Micro-Professor MPF-1B in 
the opened book housing and the related 
documentation. 


Figure 2: The board layout of the 
Micro-Professor. 


the seven-segment display to the proces- 
sor. It also provided an interface to the 
built-in loudspeaker and the connector 


INONd3-DISV8 
WOud3 / INVMH 


User Area 


Old V08Z NdD VO8Z 


212 V08Z 


7-Segment-Display 


Keyboard 





Figure 3: The MPF-1B with a connected thermal printer board. 


for the cassette recorder, which was used 
to store data and programs on audio tape - 
at the time the lowest-cost option for data 
storage. The Z80-CTC is a counter/timer IC 
containing four independent programma- 
ble counter/timers. Finally, the Z80-PIO is 
a parallel I/O component used to connect 
peripheral devices. Among other things, 
Multitech offered a thermal printer (see 
Figure 3) and an EPROM programmer as 
peripheral devices, as well as a voice output 
board. There were also other companies 
that manufactured or sold extensions 
for the Micro-Professor. For example, 
the distance learning institute Chris- 
tiani in Constance (Germany) enhanced 
its Micro-Professor curriculum with its 
own I/O card specifically designed for the 
distance learning course. 


Documentation 

The documentation for the Micro-Profes- 
sor (Figure 1) was just as minimal as the 
hardware configuration, and certainly not 
comparable to the lovingly composed user 
guide for the CP1learning computer from 
Stuttgart-based Kosmos described in the 
July/August 2018 edition of Elektor [1]. It's 
no coincidence that a renowned distance 
learning such as Christiani took up the 
Micro-Professor and published their own 
educationally oriented course. Multitech 
provided a user manual of just 95 pages for 
the MPF-1. At least the manual that came 
with my Micro-Professor was in German. 
The BASIC-MPF Operation Manual was 


only 39 pages long, and like the MPF-1 
Experiment Manual also included with the 
Micro-Professor, it was only available in the 
original English version. 


The author(s) assumed that their readers 
had a good basic knowledge of micro- 
processor technology. For example, the 
MPF-1 user manual starts with the follow- 
ing sentences (after an enumeration of 
the technical data and a brief description 
of the various keys): "The monitor program 
includes all service routines necessary to 
make things easy for the user: (1) Loading 
programs in RAM, followed by testing and/ 
or modification." Although all essential 
information, such as the Z80 instruction 
set, the programming architecture of the 
Z80, the memory structure and the I/O pin 
assignments, was available further on in 
the manual, it was mostly in tabular form 
without any sort of explanation. It was 
therefore advisable to arm yourself with 
suitable reference material, such as How 
to Program the Z80 by Rodnay Zaks. He had 
alot more to say about the Z80 - his book 
contained over 600 pages. 


Programming in Assembly 
Language 

To learn first-hand what it's like to work 
with the Micro-Professor, I took the 
example program ‘Square Root’ from the 
manual. Fortunately it was printed not only 
in the abbreviated shorthand notation of 
Z80 assembly language but also in hex, 


1800 78 LD A>»B 
1801 06 LD Bs10 


1803 21 LD HL»0000 

1806 54 LD D>H 

1807 SC LD E>H 

| 1808 D6 SUB 40 

| 1808 ED SBC HL»DE 
.30 JR NC»1812 









Figure 4: The assembly language listing of the 
square root program. 


since you can only enter hex code with 
the keyboard. First you have to press the 
ADDR key and enter the start address, then 
you can switch to data entry mode with the 
DATA key and enter the first data byte. After 
this you press the + key to advance to the 
next byte, where you can directly enter the 
next byte of the program. The program 
can be keyed in fairly quickly this way. To 
check the program, I printed it out using 
the Disassembler Listing Utility, which is 
provided by the connected thermal printer 
starting at hex address 6000 (Figure 4). 


After verifying that the printout matched 
the listing in the manual, I gave ita try. The 
task for the Micro-Professor was to calcu- 
late the square root of 81. The program 
expected to find this value (in hexadecimal 
format, of course) in processor register BC. 
Using the REG and BC keys, I could view the 
current value of this register, and with the 
DATA key I was able to enter the first byte 
(BC is a 16-bit register). At this point I was 
faced with the question of which should 
come first: 51h (equivalent to 81 decimal) 
or ooh. Guided by the principle that practi- 
cal experience takes precedence over book 
learning, I first tried ooh followed by 51h, 
which gave a completely meaningless 
result. This meant I had to start all over 
again and key in the sequence REG, BC, 
DATA, 5, 1, +, O, O (Figure 5a). To start the 
trial run, I then had to set the address to 
1800h and press the GO key (Figure 5b). 
Next came the exciting moment: I checked 
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INTERVIEW WITH MAX D. SOFFE, 


MANAGING DIRECTOR OF FLITE ELECTRONICS INTERNATIONAL LIMITED 


Max D. Soffe is a member of the Industrial Advisory Board for 
the Department of Electronic Engineering at Royal Holloway, 
University of London, and the Institute of Engineering 
Technology (www.theiet.org). From 2000 to 2004 he was 
Chairman of the Educational Technology Engineering 
Manufacturers Association (ETEMA) in Great Britain. He 
also was the Director of the British Educational Suppliers 
Association (BESA). 


Karl-Ludwig Butte: Flite Electronics International bought the 
intellectual property rights of the Micro-Professor MPF-1B from 
Acer. What was the motivation? 


Max D. Soffe: Acer used to be called Multitech. | met them on my 
first trip to Japan in 1981. They were exhibiting the MPF-1B Z80 
Microprocessor Trainer in Tokyo. | was fortunate enough to meet 
and make friends with the founders of Multitech. There were only 
20 people in the company then, and they were based in Hsinchu 
Science Park, Taipei. | made a double-page advertisement in 

a magazine called wireless world in the UK and sold a hundred 
MPF-1B in three weeks. So Multitech gave me the UK distribution 
rights, although we started selling all over the world. 


Later, Acer needed to up its turnover and wanted to concentrate 
on the booming PC market which was, as we know, very 
successful. The small Z80 trainers were effectively loss-making. 
Over 11 years, Flite Electronics had sold thousands of MPF1- 

Bs. As the product was still expensive for a private user, our 


customers were mainly tertiary education, universities and 
colleges. We were still selling a lot and so | negotiated with Acer 
to purchase the intellectual property rights. This was signed and 
sealed in February 1993. 


It wasn't as successful as I'd wanted it to be because Acer just 
washed their hands of the product leaving it to us to stop the 
"pirating" of the product. We couldn't afford to take on three 
or four companies that were simply copying all of the MPF- 
1B, its manual, PCB and firmware. However, we did carry on 
and slightly redesigned the PCB, keeping all the firmware. The 
components started to become difficult to obtain and there 
have been problems with Z80 (declared) processor, EEPROM, 
and RAM speeds. 


Karl-Ludwig Butte: There are websites on the Internet 

(e.g. https://en.wikipedia.org/wiki/Micro-Professor MPF-1) 
that say that the Micro-Professor is still manufactured and 
distributed by Flite Electronics International today. Is that 
correct? And, if so, where can readers order their unit and at 
which price? 


Max D. Soffe: Yes, of course we are still manufacturing the 
MPF-1B, albeit in very small batches. The last batch we did 

was 25 about six months ago for an order for a Middle Eastern 
university. As the lecturers, educated in the UK, have used the 
MPF-1B 20 years ago and still teach machine code/hexadecimal 
coding in their university syllabus. 


the result in register DE, and lo and 
behold it lit up with the lovely number '9' 
(Figure 5c). 


The BASIC Interpreter 

Shortly after the launch of the MPF-1, the 
MPF-1B came on the market, and after that 
the MPF-1 was called MPF-1A to distin- 
guish it from the B version. What could the 
MPF-1B do that its predecessor couldn't? 
The answer is that Multitech had added 
a new EPROM containing a small BASIC 
interpreter. I naturally wanted to try this 
out, since BASIC with a seven-segment 
display and a hex keyboard was something 
totally new for me. The MPF-1B came 
with a keyboard overlay for his purpose, 
which in the case of my device had long 
since gone missing. Nowadays the Inter- 
net is the answer to this sort of problem. I 
quickly found the template and printed it 





Figure 5: A: Input value 87 


in register BC. 
B: Start address. C: Result 9 in register DE. 


dec 





Figure 6: The Micro-Professor in BASIC mode 
with the keyboard overlay template. 
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If Elektor readers email sales@flite.co.uk, and be patient, we will 
answer their email and give them a quotation. We have about 
eight in stock. Please note when those units are sold, it could 
be two to three months before we build another batch. | have 
noticed there are a few second-hand units being sold on eBay. 


As I've explained, the components are now quite expensive for 
what they are, and you can tell by the production date code 

on the IC (e.g. 9243) that the components were manufactured 

in the 43rd week of 1992. So, we do spend a lot of time testing 
components and the finished product for speed and race 
conditions with component incompatibility failures. For this 
reason, we have all the ICs on sockets. So we can quickly jockey 
ICs around. Obviously, when we supply a finished new unit, it is 


in hexadecimal programming. As we know, computers work 

on binary and the next step up from that is hexadecimal. The 
beauty of hexadecimal coding was in the time when memory 
was expensive and very limited. The Micro-Professor taught 

the student to write very tight code, and not sloppy code as 
many coders do nowadays. Indeed, it is not really coding by just 
moving cartoon balloons around. 


Karl-Ludwig Butte: What is Flite Electronics International's main 
business today? 


Max D. Soffe: Due to the pirating of the Micro-Professor during 
the 1990s, Flite Electronics teamed up with a company in 
Taiwan called K&H which manufactures educational technology 


fully working and guaranteed for a year. 


Due to all of this we realise we will never make a successful 
business model out of such a product. It was a stepping stone 
for Acer to become a massive international brand, but like Acer 
the Micro-Professor will never make us any notable profits. 
Unfortunately, we cannot afford to sell the product for less than 


£250 plus VAT and postage. 


Karl-Ludwig Butte: What kind of documentation do you deliver 


with the Micro-Professor? 


Max D. Soffe: The documentation is very important. We deliver 
each Micro-Professor with a Student Workbook. This manual 
should take the student from unpacking and powering up 

the micro system through to understanding microprocessor 


equipment. This was because our customer base was mainly 
educational establishments, not private individuals. We are 


K&H's UK educational technology product distributors. We 
recently installed a £240,000 electrical machines laboratory in 
Coventry University. We didn't design the system, we integrated 
it from existing K&H modules. Last week, we added a £50,000 
extension to this laboratory. 


Also, we do still supply general microprocessor trainers for the 


Motorola 68000, the Intel 8086, and the 8032 microcontroller; 


here again we sell 10 of each a year, mainly supporting existing 
customers and agents, but we will be happy to quote on these 


systems, architecture, hardware, software and interfacing. It 


was initially intended to be a self-teach manual to train students 


out on fairly heavy paper. Cutting out the 
holes with a scalpel took a little while. The 
admirable result can be seen in Figure 6. 


As an example program, I chose a routine 
from the BASIC-MPF Operation Manual that 
can generate multiple signal tones. The 
BASIC interpreter is located in memory 
with a starting address of 0800h and can 
be launched with the GO command. It 
announces its presence with ‘bASIC’ on 
the display, as can be seen in Figure 6. 
Now the program can be entered. First 
the line number, then the BASIC state- 
ment, followed by any variables, numbers 
or parameters. Each BASIC statement can 
be entered with its own keypress. Finally, 
you press ENTER, just like the old days 
with an Apple II, PET 2001 or TRS-80. 
Everything worked fine up to a point, but 
I had trouble entering the statement FOR 


A=1 TO C. Instead of the equal sign, I kept 
seeing a5 on the display, despite pressing 
the SHIFT key first. That turned out to be 
due to an old habit: as the keyboard of the 
Micro-Professor so closely resembles the 
keypad of a pocket calculator, I was press- 
ing and releasing the SHIFT key instead of 
holding it pressed, as witha PC. It tooka 
while before I realised that the Micro-Pro- 
fessor considers itself to be a sort of PC, so 
I had to hold the SHIFT key down while 
pressing the = key. 


After surmounting this small obstacle, 
entering the rest of the program was easy. 
Figure 7 shows a couple of examples of 
how BASIC instructions are represented 
on the seven-segment display. Figure 7a 
is 10 Input Cinnormal notation, while 
Figure 7b represents the line 50 Next B. 
The manual contains a table of the BASIC 


products. Another add-on product that we designed back in the 
1990s to add on to all our microprocessor training systems Is an 
all-in-one laboratory called the APB (applications board). This 
too comes with a training manual. 


Karl-Ludwig Butte: Thank you very much for this interview. 








Figure 7: A: 10 Input C. B: 50 Next B. C: Input 
prompt. 
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FOR B-1 TO 1000 
NEAT EB 
NEAT A 





Figure 8: Example BASIC program printout on 
the thermal printer. 


instructions and their respective repre- 
sentations on the display. This is certainly 
necessary, since in some cases you need a 
lot of imagination. Editing is also possible, 
but it makes the vi editor from the Unix 
world look very user friendly. 


Now it’s time to try the BASIC program we 
just entered. After you start the program 
with the RUN key, you are first asked for 
the number of signal tones to be gener- 
ated (Figure 7c). I entered 3 and pressed 
ENTER, and then I heard three relatively 
high-pitched tones, exactly as expected. 


With a relatively long program, there is a 
fairly good chance of typos somewhere. 
In my view, trying to find typos with only 
a cryptic seven-segment display appears 
very tedious. Fortunately, BASIC programs 
can be printed out as normal text if you 
have a printer connected to the system. 


RELATED PRODUCTS 





Figure 9: The Micro-Professor from Flite Electronics International (left) and its counterpart from 
Multitech (right). 


Figure 8 shows the listing of the signal 
tone program. 


A Worthy Endeavor 

One thing is certain: once you have worked 
extensively with the Micro-Professor, you 
will be on a first-name basis with every bit 
ofthe Z80 microprocessor and its peripher- 
als. The path is not always easy, and you will 
need persistence, but in my view, it's worth 
the effort. It's also amazing how similar the 
concepts are to the "Assembler Crash Course" 
series by Miroslav Cina published in Elektor 
starting with theJuly/August 2015 edition [2]. 


In the course of researching this article, 
I found indications on the Internet that 
the Micro-Professor MPF-1B is still being 
manufactured and sold. I checked out these 
indications and contacted the company 
Flite Electronics International Ltd in 
Waltham Chase, Hampshire, Great Britain 


» E-book: Assembly Language Essentials (SKU19186) 
www.elektor.com/assembly-language-essentials-e-book 


—— WEB LINKS 


[3]. They confirmed that they have acquired 
the rights to the Micro-Professor and are 
still manufacturing the device. Figure 9 
shows the Micro-Professor from Flite 
Electronics side by side with its Taiwanese 
counterpart from Multitech. Flite Electron- 
ics generously provided me with a sample 
product, and I can confirm that it is of excel- 
lent quality. Of course, I wanted to know 
all the details, and Max D. Soffe, Managing 
Director of Flite Electronics, kindly agreed 
to an interview (see inset). I 

200679-01 


Questions or Comments? 

Do you have any technical questions 
or comments about this article? Please 
contact the author via 
LKL_Butte@web.de or the editor via 
editor@elektor.com. 


Contributors 

Text and images: Karl-Ludwig Butte 
Editor: Jens Nickel 

Translation to English: Kenneth Cox 
Layout: Giel Dols 





[1] Butte, Karl-Ludwig: "Introduction to Microprocessor Technology with the Kosmos CP1 (1983)’, Elektor 7-8/2018: 
www.elektormagazine.com/magazine/elektor-201807/41747 


[2] Cina, Miroslav: "PIC? Assembler Crash Course’, Elektor 7-8/2015: www.elektormagazine.com/magazine/elektor-201507/27958 


[3] Flite Electronics International Limited: www.flite.co.uk 
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Btarting Out 
a Electronics (7) 


Easier Than Imagined! 






Even When It Is About Capacitors 


By Eric Bogers (Elektor) 


After the resistors that we 
discussed in the previous 
episode [1], itis now the 
Capacitors turn. Capacitors 
also can be considered 
resistors, but for AC signals. 
That is because capacitors 
do not allow DC signals to 
pass, but AC signals can 
pass through. Capacitors 
are not only used as an AC 
resistance, but can also 

be used to store electrical 
energy. 


A capacitor can be considered to be two 
conductors (metal plates, for example, or 
more generally, electrodes) that are placed 
a very short distance from each other, but 
do not actually make electrical contact with 
each other. This concept is also expressed in 
the schematic symbol (Figure 1): two parallel 
lines that are not connected together. 


Figure 1: Schematic symbols for capacitors. 


From left to right: ‘ordinary’ capacitor, adjustable 
capacitor (‘trimmer’), electrolytic capacitor. 





But hang on! How is it possible that a compo- 
nent does not allow DC signals to pass but 
does allow AC signals to pass? We can make 
this clear when we consider what ‘current’ 
really is: the transport of charge. When charge 
is transported, a current flows. When we 
connect a capacitor to a DC voltage, there 
will be an initial current — electrons move 
from one plate of the capacitor to the positive 
terminal of the DC voltage source, and from 
the negative terminal, electrons move to 
the other plate. But once the capacitor has 
been charged in this way, the electrons have 
nowhere else to go any more — they cannot 
move magically from one plate to the other. 
There is no longer any current flow, and the 
capacitor behaves as an open circuit (or isola- 
tor, or resistor with an infinitely high value). 


This is different when an AC voltage is 


connected to the capacitor: the capacitor 
is then continuously charged, discharged, 
charged in the opposite polarity, etc. — and 
then a current most certainly flows back 
and forth (an AC current, that is). And, to be 
absolutely clear, no electrons actually move 
through the capacitor from one plate or 
electrode to the other! 


Capacitance 

We have already touched on this: a capac- 
itor can store charge (and therefore electri- 
cal energy) — and it can do more of that the 
bigger the capacitance of that capacitor is. 


For the capacitance C of a capacitor, the 
following is true: 


foe 
|. d 
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Figure 2: Construction of a Leyden Jar 
(Source: Wikimedia Commons, http://bit.ly/ 
wiki-leyden-jar). 





Figure 3: A few common capacitor types. 


Here e is the dielectric constant; A is the 
surface area of the electrodes (‘plates’); and 
dis the distance between the plates. There is 
no real need to remember this formula, and 
you may promptly forget it again. We only 
show it to you so that you have an idea of what 
the units are that determine the capacitance 
of a capacitor. 


It is obvious that the capacitance increases 
with the surface area of the electrodes ('the 
bigger they are, the more charge fits in). When 
the electrodes are placed closer to each other, 
the capacitance also increases. The dielectric 
constant, which has a large influence on the 
capacitance, requires a little more explanation. 


Between the electrodes of a capacitor is a 
non-conducting medium (‘material’). For the 


dielectric constant e, we have the following 
relationship: 


Eee. 
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Here eg is the permittivity of free space (a 
natural constant with an extremely small value 
of 8.85.1071? C2/N-m2), and e, is the relative 
dielectric constant of the medium, which is a 
characteristic of the material. For paper, e, has 
the value of 2; in vacuum and air the value is 
1; and for ceramic and mica the value is 7. It 
should be clear that through a suitable choice 
of dielectric the capacitance of a capacitor 
can be increased considerably. 


The capacitance of a capacitor is expressed 
using the unit farad (abbreviated F). This turns 
out to be an impractically large unit in practice; 
we normally deal with values in the order of 
a picofarad (10-12 F), nanofarad (10-9 F) and 
microfarad (10-6 F). Capacitors with values of 
1.10 F or even more do, however, exist: these 
are the so-called supercaps that are available 
from various manufacturers and are used as a 
kind of back-up battery (for example, to keep 
a real-time clock circuit going when the mains 
power fails). 


Appearance 

The capacitor made its debut in the 
year 1746 in the laboratory of Pieter van 
Musschenbroeck at the University of Leiden. 
This capacitor consisted of a (glass) jar with 
the inside and outside covered with tin foil 
(Figure 2). Combined with an electrostatic 
generator that provided the charge, this 
Leyden jar was capable of spectacular (and 
certainly not entirely safe) experiments. 


These days, capacitors can (fortunately) be 
made much smaller. The most common imple- 
mentations can be seen in Figure 3. At the 
far right we see a literally ‘fat’ metal/paper 
capacitor; these capacitors are often used for 
the noise suppression of motors. An advan- 
tage is that these capacitors are very robust; 
a disadvantage, however, is that they are not 
particularly small. 


Electrolytic capacitors are considerably 
smaller (Figure 3, middle column). In electro- 
lytic capacitors the dielectric is an electro- 
lyte; a significant disadvantage of this type 
of capacitor, however, is that they are polar- 
ised, that means they have a positive and a 
negative terminal. These capacitors definitely 
have to be fitted the correct way around; 
mistakes can have (and in particular with the 
so-called tantalum capacitors) spectacular 
and extremely malodorous consequences. 
There do exist bipolar electrolytic capacitors, 
with these it makes no difference in which 
orientation (with which polarity) they are used. 


The left-most column of Figure 3 shows a 
few polypropylene capacitors at the top and 
a few ceramic capacitors at the bottom. The 
latter are pleasantly small and cheap, but 
are only available in relatively small capac- 
itance values. 


There is so much to say about all the different 
types of capacitors that are available and their 
specific characteristics that we could easily 
fill an entire issue of Elektor with that. But 
when you are taking your first steps down the 
electronics path, the above-mentioned types 
will generally cover your needs. By doing you 
will learn about the other types — don't you 
worry about that! 


The Capacitor as an Energy 
Reservoir 

A capacitor can store electrical charge, and 
more as its capacitance is higher and the 
voltage is higher: 


From this follows the official definition of the 
unit of capacitance, the farad: the capacitance 
of a capacitor is the amount of charge that can 
be stored at a voltage of one volt. The energy 
stored in a capacitor is calculated as follows: 


w=: C+ U? 
2 


We mainly come across capacitors as energy 
reservoirs in mains power supplies: the 
(downwards transformed) AC voltage is recti- 
fied, resulting in a pulsing DC voltage; this is 
stored in a (fairly big) capacitor that functions 
as a reservoir or buffer - this is called buffering 
or smoothing of the voltage and this capac- 
itor is called a buffer or smoothing capaci- 
tor. Once we get to the topics of diodes and 
rectifier circuits we will take a closer look at 
this subject. 


Charge and Discharge 
Characteristics 

When a capacitor is charged or discharged, 
the voltage across the capacitor depends on 
the charge that is present: 


If we charge a capacitor with a constant 
current, then the voltage across the capaci- 
tor increases linearly - and when discharg- 
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Figure 4: Periodic charging and discharging of a 
capacitor through a resistor. 


ing with a constant current, the voltage 
reduces linearly. In practice capacitors are 
seldom charged or discharged with a constant 
current; it is much more common to use a 
constant voltage (Figure 4). 


Because the voltage across the capacitor 
continually increases while it charges, the 
voltage across the resistor will continually 
decrease (after all, the voltage across the 
resistor is equal to the constant charging 
voltage minus the voltage across the capac- 
itor) and that, of course, means that the 
charging current is continually decreasing. 
And that also means that the charging of the 
capacitor becomes increasingly slower; the 
voltage across the capacitor asymptotically 
approaches the charging voltage (Figure 5). 


When discharging a capacitor through a resis- 
tor the exact opposite happens: as a conse- 
quence of the high capacitor voltage, there is 
an initial large discharge current, but because 
the voltage across the capacitor is continu- 
ally decreasing, the discharge current also 
becomes progressively smaller. 


When charging a capacitor through a resis- 
tor, the relationships for voltage and current 
below hold (we will not trouble you with the 
derivation of these; and you may just as well 
forget them again, we only show them here 
for completeness sake): 


Uc = Us (1 — RE) 


Uo 
—_—- 
C R 


(e-t/RC) 
And for discharging these formulas apply: 


Uc = Ug i (ee) 


I m 2 (ud 





Figure 5: This is what the charge and discharge 
cycles look like on an oscilloscope. 


Series and Parallel Connections 
of Capacitors 

To wrap this episode up, we will take a brief 
look at the series and parallel connections of 
capacitors. Connection in parallel is actually 
very simple: when we connect capacitors in 
parallel, we can imagine that the 'plates' of the 
resulting combined capacitor have become 
larger and therefore the capacitance that 
results will also be larger. This holds: 


Ciotat. Gy "EGG, 


But this is great! For capacitors connected 
in parallel the same relationship applies as 
for the series connection of resistors! Would 
something similar apply for the series connec- 
tion of capacitors? Indeed: when connect- 
ing capacitors in series the same relation- 
ship holds as for the parallel connection of 
resistors: 
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Questions or Comments? 

Do you have questions or comments 
regarding this article? Then email 
Elektor at editor@elektor.com. 


Contributors 

Idea and illustrations: Michael Ebner 
Text and editing: Eric Bogers 
Translation: Arthur de Beun 

Layout: Giel Dols 


— WEB LINK 





THF = lle 


Figure 6: Two electrolytic capacitors in anti- 
series form a bipolar electrolytic capacitor. 


Finally a remark about electrolytic capaci- 
tors: when two electrolytic capacitors are 
connected in ‘anti-series, the resulting circuit 
is a bipolar electrolytic (Figure 6). 


We leave it at this for this episode. In the next 
episode, we will take a close look at capacitors 
acting as AC resistors. There is quite a bit to 
be said about that, because with capacitors, 
there is a phase shift between voltage and 
current — this is in contrast to resistors. M 
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Hexadoku The Original Elektorized Sudoku 


Traditionally, the last page of Elektor magazine is reserved for our puzzle with an electronics 
slant: welcome to Hexadoku! Find the solution in the gray boxes, submit it to us by email, 
and you automatically enter the prize draw for one of five Elektor store vouchers. 


The Hexadoku puzzle employs numbers in the hexadecimal range o 
through E In the diagram composed of 16 x 16 boxes, enter numbers 
such that all hexadecimal numbers o through F (that's o-9 and A-F) 
occur once only in each row, once in each column and in each ofthe 
4x4 boxes (marked by the thicker black lines). A number of clues 
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